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you need the most help 

• real-world case scenarios built around common workplace documents 
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CASES 


Document-based cases, previously included at the end of each chapter, are now presented online, where you can familiarize yourself 
with each scenario, download and work with related documents, and access assignment questions in a single space. 


CASE 1 : Using the Measures of Excellence in Evaluating a 
Resume 

CASE 2: The Ethics of Requiring Students To Subsidize a 
Plagiarism-Detection Service 
CASE 3: Understanding Why Revision Software Cannot 
Revise and Edit Your Document 
CASE 4: Accommodating a Team Member's Scheduling 
Problems 

CASE 5: Focusing on an Audience's Needs and Interests 
CASE 6: Revising a Questionnaire 

CASE 7: Organizing a Document for Clarity — and Diplomacy 
CASE 8: Analyzing the Persuasiveness of a Website 
CASE 9: Emphasizing Important Information in a Technical 
Description 

CASE 1 0: Revising a Document for Nonnative Speakers and 
forTranslation 


CASE 1 1 : Designing a Flyer 

CASE 1 2: Creating Appropriate Graphics To Accompany a 
Report 

CASE 1 3: Revising a Document for a New Audience 

CASE 14: Setting Up and Maintaining a Professional 
Microblog Account 

CASE 15: Identifying the Best-of-the-Best Job-Search Sites 

CASE 1 6: Revising a Brief Proposal 

CASE 1 7: Writing a Directive About Using Agendas for 
Meetings 

CASE 18: Analyzing Decision Matrices 

CASE 1 9: Introducing the Scientific Method Through a Lab 
Report 

CASE 20: Choosing a Medium for Presenting Instructions 

CASE 21 : Understanding the Claim-and-Support Structure 
for Presentation Graphics 


DOWNLOADABLE FORMS 


Download and work with a variety of helpful forms discussed throughout the text. 

Work-Schedule Form (Chapter 4) Audience Profile Sheet (Chapter 5) 

Team-Member Evaluation Form (Chapter 4) Oral Presentation Evaluation Form (Chapter 21 ) 

Self-Evaluation Form (Chapter 4) 


LEARNINGCURVE 


Master the material covered in the first ten chapters of the text as well as key skills for multilingual writers with LearningCurve, a fun 
adaptive quizzing program that meets you where you are and gives you the extra support you need when you need it. 


Understanding theTechnical Communication Environment 
(Covering Part 1 : Chapters 1 -4) 

Analyzing Your Audience and Purpose (Covering Chapter 5) 
Researching Your Subject (Covering Chapter 6) 

Organizing and Emphasizing Information (Covering Chapters 
7 and 9) 

Communicating Persuasively (Covering Chapter 8) 

Writing Correct and Effective Sentences (Covering Chapter 10) 


Articles and Nouns for Multilingual Writers (Covering 
Appendix Part D: Guidelines for Multilingual Writers) 
Prepositions for Multilingual Writers (Covering Appendix 
Part D: Guidelines for Multilingual Writers) 

Sentence Structure for Multilingual Writers (Covering 
Appendix Part D: Guidelines for Multilingual Writers) 
Verbs for Multilingual Writers (Covering Appendix Part D: 
Guidelines for Multilingual Writers) 








DOCUMENT ANALYSIS ACTIVITIES 


Explore real multimedia documents that harness digital technologies in exciting new ways, and respond to prompts that will help 
you analyze them. 


Interactive Graphic: Tom Giratikanon and David Schutz, 

How Hard the Wind Will Hit Your Area, and When 
(Chapter 12) 

Online Portfolio: Biane C. Holden's Online Portfolio 
(Chapter 15) 

Proposal Delivered as a Prezi Presentation: Andrew 
Washuta, Marketing Proposal Presentation (Chapter 1 6) 

Report Presented as a Website: United States Geological 
Survey, High Plains Water-Level Monitoring Study 
(Chapter 17) 

Informational Report Presented Through an Interactive 
Graphic: Matthew C. Hansen et al.. University of 
Maryland, Google, USGS, and NASA, "Global Forest 
Change" Interactive Map (Chapter 17) 

Recommendations Presented in an Audio Podcast: Centers 
for Disease Control, Influenza 2010-201 1, ACIP Vaccination 
Recommendations (Chapter 18) 


Mechanism Description Using Interactive Graphics: 
Hybridcenter.org and Union of Concerned Scientists, 
Hybrids Under the Hood (Part 2) (Chapter 20) 

Process Description Using Video Animation: North Carolina 
Department of Transportation (NCDOT), Diverging 
Diamond Interchange Visualization (Chapter 20) 
Instructions Using Video Demonstration: PartSelect, Dryer 
Repair — Replacing the High Limit Thermostat (Chapter 20) 
Instructions Using Video Screen Capture: TechSmith, Jing 
Learning Center: Capture a Video (Chapter 20) 
Instructions Using a Combination ofVideo Demonstration 
and Screen Capture: Texas Tech University Multiple 
Literacy Lab (MuLL), Recording Audio in the Field Using an 
iTalk (Chapter 20) 

Definition Using Video Animation: ABC News, What Is the 
Cloud? (Chapter 20) 


TEAM WRITING MODULES 


These modules, built around five short videos of real team interactions, focus on the role of written communication in teamwork. 
They'll teach you howto use written documentation to manage a team by producing task schedules, minutes, charters, and other 
materials and also provide models for working on large collaborative documents. 


Methods of Collaboration in Team 1 
Responses and Outcomes forTeam 1 
Methods of Collaboration in Team 2 
Creating Meeting Minutes for Team 3 
Considering a Team Charter for Team 5 
Creating a Task Schedule forTeam 2 
Conflict Management in Team 4 


Responses and Outcomes forTeam 4 
Conflict Management in Team 5 
Responses and Outcomes forTeam 5 
Responses and Outcomes forTeam 3 
Competitive versus Considerate Conversation in 
Teams 1 and 3 

Self-Promoting versus Self-Deprecating Speech in 
Teams 3 and 4 


TUTORIALS 


Engaging tutorials show you helpful tools and tips for creating your projects along with guidance on how to best use them, as well as 
the documentation process for citing the sources you use in MLA and APA style. 


DIGITAL WRITING TUTORIALS 

Cross-Platform Word Processing with CloudOn, Quip, and 
More (Chapter 3) 

Tracking Sources with Evernote and Zotero (Chapter 6) 
Photo Editing Basics with GIMP (Chapter 1 2) 

Building Your Professional Brand with Linkedln, Twitter, and 
More (Chapter 1 5) 

Creating Presentations with PowerPoint and Prezi (Chapter 21) 
Audio Recording and Editing with Audacity (Chapter 21) 

DIGITAL TIPS TUTORIALS 

Creating Outlines (Chapter 3) 

Creating Styles and Templates (Chapter 3) 

Scheduling Meetings Online (Chapter 4) 

Reviewing Collaborative Documents (Chapter 4) 
Incorporating Tracked Changes (Chapter 4) 

Conducting Online Meetings (Chapter 4) 


Using Wikis for Collaborative Work (Chapter 4) 

Using Collaborative Software (Chapter 4) 

Proofreading for Format Consistency (Chapter 1 1) 

DOCUMENTATION TUTORIALS 

HowTo Cite a Database in APA Style (Appendix B: 
Documenting Sources) 

HowTo Cite a Website in APA Style (Appendix B: 
Documenting Sources) 

HowTo Cite an Article in MLA Style (Appendix B: 
Documenting Sources) 

HowTo Cite a Book in MLA Style (Appendix B: 
Documenting Sources) 

HowTo Cite a Database in MLA Style (Appendix B: 
Documenting Sources) 

HowTo Cite a Website in MLA Style (Appendix B: 
Documenting Sources) 
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Preface for Instructors 


TECHNICAL COMMUNICATION has always involved collaboration. A writer 
who needed to produce a user manual for a new software package would 
likely have interviewed the engineer who wrote the code. The company 
might also have convened a focus group to find out what users liked and 
didn’t like about the prototype of the software. Now, however, there is more 
interaction than ever before between the people who produce technical doc- 
uments and those who consume them. Often, that interaction goes in both 
directions. Using social media and new technologies, technical communica- 
tors can collaborate with their audiences at every step of the communication 
process. And thanks to online publishing, audience members contribute to 
the development of technical documents even after they have been pub- 
lished, by asking and answering questions, revising existing information, and 
contributing new information. 

The types of documents that technical communicators routinely produce 
have changed as well. Microblog posts, contributions to discussion boards 
and wikis, and status updates to one’s Linkedln profile — once the raw materi- 
als of longer and more formal documents — are now routinely used to com- 
municate important messages. 

Despite these changes, the fundamentals of technical communication are 
at least as important as they always have been. An inaccuracy in a microblog 
post communicating a project update is every bit as big a problem as an inac- 
curacy in a traditional progress report. And even though we live and work in 
an era that values brevity and quick turnaround, some information can be 
properly communicated only through the longer, detailed documents that 
have always been at the center of technical communication. 

I have revised this new edition of Technical Communication to help students 
learn how to communicate effectively in the fast-paced, highly collaborative 
world in which they will work. Employers have never valued communication 
skills as much as they value them today, and for good reason. Today’s profes- 
sionals need to communicate more frequently, more rapidly, more accurately, 
and with more individuals than ever before. This book will help prepare stu- 
dents to do so — in their courses and in their careers. 
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New to This Edition 

The Eleventh Edition recasts the text’s most enduring features in the context 
of today’s professional environment. Chapter 1, thoroughly revised in light 
of the input of fellow technical-communication instructors, sets the stage 
for the text’s new focus. Throughout, I’ve updated and expanded coverage 
of the topics and technologies most relevant to the technical communica- 
tion process; in fact, I’ve eliminated Chapter 22, “Connecting with the Public,” 
altogether, as its topics are now integrated into many chapters throughout 
the text. 

The chapter about audience includes an expanded introduction that pre- 
pares students who are, for the first time, considering audiences other than 
their instructors. In addition, this chapter presents techniques for analyzing 
social-media data to better understand those audiences. The correspondence 
chapter now includes guidelines on how to represent one’s organization 
on a microblog. The chapter on definitions, descriptions, and instructions 
covers the new role of discussion boards, wikis, and videos in disseminat- 
ing information. Updated sample documents, both in the print text and 
online, provide opportunities for students to analyze the types of documents 
they’ll need to produce or contribute to, such as a municipal government app 
that enables residents to report infrastructure problems directly from their 
phones, as well as an interactive map of global forest changes that allows dif- 
ferent audiences to customize their viewing experience to obtain the precise 
information they need. 

In keeping with its promise of serving as a model of the principles it 
teaches, the new edition communicates in new ways. Online resources, 
labeled in the text with an E3 icon, are located in the LaunchPad, a customiz- 
able online course space including a full e-book that can be packaged with 
new copies of the text for free. Cases are now presented in the LaunchPad so 
that students can easily download and work with related documents. Tutori- 
als introduce tools for multimodal composition, teach helpful technology 
tips, and offer another means of learning documentation. LearningCurve 
adaptive quizzing activities, covering the first ten chapters, help students 
master and apply concepts in a new, personalized way. LearningCurve activi- 
ties for multilingual writers are also available here, as are video-based team 
writing modules that help students learn collaborative writing skills. Also 
available in the LaunchPad are two full-length e-books: Document-Based Cases 
for Technical Communication, Second Edition, by Roger Munger, and Team Writ- 
ing, by Joanna Wolfe. Finally, instructors can access a variety of instructor 
resources here, including a new test bank featuring multiple-choice, true/ 
false, and short-answer questions for each chapter. 

The following table describes the updates made to each chapter in the 
Eleventh Edition. 
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CHAPTER 

WHAT'S NEW 

Chapter 1 

Introduction to Technical 
Communication 

• 

• 

• 

• 

• 

New focus on continuous collaboration between technical communicators and stakeholders 
A discussion of the challenges related to producing technical communication and how to 
meet them 

A discussion of the skills and qualities shared by successful workplace communicators 
New annotated sample documents that set the stage for those that will follow throughout 
the text, such as a company blog post and comment thread 

LearningCurve: Understanding theTechnical Communication Environment, covering 
Chapters 1-4 S3 

Chapter 2 

Understanding Ethical 
and Legal Considerations 

• 

• 

• 

A discussion of ethical and legal issues related to social media, including guidelines for using 
social media ethically in the workplace 

Document Analysis Activity: Presenting Guidelines for Using Social Media 
LearningCurve: Understanding theTechnical Communication Environment, covering 
Chapters 1-4 J3 

Chapter 3 

Writing Technical 
Documents 

• 

• 

• 

• 

Advice on choosing the best digital writing tool for a project 

Document Analysis Activity: Identifying the Strengths and Weaknesses of a Commercial 
Template 

Tutorials on cross-platform word processing and on creating outlines, styles, and 
templates 

LearningCurve: Understanding theTechnical Communication Environment, covering 
Chapters 1-4 S3 

Chapter 4 

Writing Collaboratively 

• 

• 

Tutorials on scheduling and conducting meetings online, reviewing collaborative documents, 
incorporating tracked changes, using wikis for collaborative work, and using collaborative 
software S3 

LearningCurve: Understanding theTechnical Communication Environment, covering 
Chapters 1-4 0 

Chapter 5 

Analyzing Your Audience 
and Purpose 

• 

• 

• 

• 

A new, more-detailed introduction to the role of audience and purpose 
Advice on using social-media data in audience analysis 
Case: Focusing on an Audience's Needs and Interests 
LearningCurve: Analyzing Your Audience and Purpose S3 

Chapter 6 

Researching Your Subject 

• 

• 

• 

Advice on using social-media data in research 
A tutorial on tracking sources using online research tools 
LearningCurve: Researching Your Subject S3 

Chapter 7 

Organizing Your 
Information 

• 

• 

Document Analysis Activity: Using Multiple Organizational Patterns in an Infographic 
LearningCurve: Organizing and Emphasizing Information, covering Chapters 7 and 9 S3 

Chapter 8 

Communicating 

Persuasively 

• 

• 

Case: Analyzing the Persuasiveness of a Website 
LearningCurve: Communicating Persuasively 

Chapter 9 

Emphasizing Important 
Information 

• 

• 

• 

New focus on emphasizing important information at various document levels 
Case: Emphasizing Important Information in a Technical Description S3 
LearningCurve: Organizing and Emphasizing Information, covering Chapters 7 and 9 J3 

Chapter 10 

Writing Correct and 
Effective Sentences 

• 

• 

Instruction on writing grammatically correct sentences relocated from Appendix C 
LearningCurve: Writing Correct and Effective Sentences S3 



Preface for Instructors 


VIII 


CHAPTER 

WHAT'S NEW 

Chapter 1 1 

Designing Print and 
Online Documents 

• Advice on designing documents for mobile screens 

• A tutorial on proofreading for format consistency 

Chapter 12 

Creating Graphics 

• A discussion of infographics 

• Document Analysis Activity: Interactive Graphic 

• Tutorial on editing photos 0 

Chapter 13 

Reviewing, Evaluating, 
and Testing Documents 
and Websites 

• Case: Setting Up and Maintaining a Professional Microblog Account 

Chapter 14 

Writing Correspondence 

• Guidelines for representing your organization on a microblog 

Chapter 15 

Writing Job-Application 
Materials 

• Advice on establishing your professional brand 

• Guidelines on creating and using a Linkedln profile 

• Tutorial on building a professional brand online 

• Document Analysis Activity: Blane C. Holden's Online Portfolio 0 

• Case: Identifying the Best-of-the-Best Job-Search Sites 0 

Chapter 16 

Writing Proposals 

• Sample internal proposal: Tablet Study at Rawlings Regional Medical Center 

• Document Analysis Activity: Marketing Proposal Presentation 

Chapter 17 

Writing Informational 
Reports 

• Sample progress report: Tablet Study at Rawlings Regional Medical Center 

• Document Analysis Activity: High Plains Water-Level Monitoring Study 0 

• Document Analysis Activity: "Global Forest Change" Interactive Map 

Chapter 18 

Writing Recommendation 
Reports 

• Sample recommendation report: Tablet Study at Rawlings Regional Medical Center 

• Document Analysis Activity: Influenza 2010-201 1 : ACIP Vaccination Recommendations 0 

Chapter 19 

Writing Lab Reports 

• Relocated from Chapter 1 8 to enable the three chapters using the sample report suite (Tablet 
Study at Rawlings Regional Medical Center) to appear consecutively 

Chapter 20 

Writing Definitions, 
Descriptions, and 
Instructions 

• Discussion on the role of social media in the dissemination of instructional information 

• Guidelines for designing instructional videos 

• Document Analysis Activity: Presenting Clear Instructions 

• Document Analysis Activity: Mechanism Description Using Interactive Graphics 

• Document Analysis Activity: Process Description Using Video Animation 0 

• Document Analysis Activity: Instructions Using Video Demonstration 

• Document Analysis Activity: Instructions Using Video Screen Capture 

• Document Analysis Activity: Instructions Using a Combination of Video Demonstration and 
Screen Capture 0 

• Document Analysis Activity: Definition Using Video Animation 

• Case: Choosing a Medium for Presenting Instructions 

Chapter 21 

Making Oral 
Presentations 

• A discussion on creating presentation materials using Prezi 

• Tutorials on creating presentation slides and on recording and editing audio for recorded 
presentations and other projects 0 
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Get the Most out of 

Technical Communication, Eleventh Edition 

The Eleventh Edition of Technical Communication lives not only in print but 
online, where you and your students will find an array of engaging resources 
to enhance your course. Bedford/St. Martin’s offers resources and format 
choices that help you and your students get even more out of your book 
and course. To learn more about or to order any of the following products, 
contact your Macmillan sales representative, email sales support (Sales 
_Support@macmillanusa.com), or visit the website at macmillanhighered 
.com/techcommlle. 

LaunchPad for Technical Communication: Where Students Learn 

LaunchPad provides engaging content and new ways to get the most out of your 
course. Get an interactive e-book combined with unique, book-specific materi- 
als in a fully customizable course space; then mix our resources with yours. 

• Prebuilt units — tutorials, quizzes, and more — are easy to adapt and 
assign. Add your own materials and mix them with our high-quality 
multimedia content and ready-made assessment options, such as 
LearningCurve adaptive quizzing. 

• LaunchPad also includes access to a gradebook that provides a clear 
window on the performance of your whole class and individual students, 
overall and on individual assignments. 

• A streamlined interface helps students focus on what’s due, and social- 
commenting tools let them engage, make connections, and learn from each 
other. Use LaunchPad on its own or integrate it with your school’s learning 
management system so that your class is always on the same page. 

LaunchPad for Technical Communication, Eleventh Edition, includes the fol- 
lowing book-specific media materials: 

• Cases Previously located at the end of each chapter, these document- 
based cases now live online, making it easy for students to familiarize 
themselves with the case scenarios, download and work with related 
documents, and complete their assignments. 

• Document Analysis Activities The online equivalent of the Document 
Analysis Activities (formerly Interactive Sample Documents) included 
in the print book, these models introduce students to the kinds 

of multimedia documents that can exist only online — such as a 
recommendation report presented as a podcast and a definition delivered 
via video and animation. Each model is accompanied by a set of 
assessment questions to guide students in their analysis. 

• Downloadable Forms Students can download and work with a variety of 
forms discussed throughout the text, including an audience profile sheet, a 
team-member evaluation form, and an oral presentation evaluation form. 
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• LearningCurve LearningCurve is an adaptive, game-like quizzing 
program that helps students master comprehension and application of 
the course material. Six LearningCurve activities cover material from the 
first ten chapters of the text (the first four chapters are covered in the 
activity “Understanding the Technical Communication Environment,” 
and Chapters 7 and 9 are covered in the activity “Organizing and 
Emphasizing Information”), as well as key topics for multilingual writers. 

• Team Writing Assignment Modules Based on Team Writing by Joanna 
Wolfe, these modules focus on the role of written communication in 
teamwork. The modules are built around five short videos of real team 
interactions. They teach students how to use written documentation to 
manage a team by producing task schedules, minutes, charters, and other 
materials and also provide models for working on large collaborative 
documents. 

• Test Bank Instructors using LaunchPad have access to a robust test bank 
which offers multiple-choice, true/false, and short-answer questions for 
each chapter. 

• Tutorials Engaging tutorials present digital tips and introduce students to 
helpful multimodal composition tools, such as Prezi and Audacity, providing 
guidance on how to best use them for projects. Documentation tutorials 
provide a fun new way for students to learn citation. 

• Full-Length e-Books The LaunchPad includes access to two e-books: 
Document-Based Cases for Technical Communication, Second Edition, by Roger 
Munger, and Team Writing, by Joanna Wolfe. 

For a complete list of LaunchPad content, see the inside front cover of this 
book. 

To get the most out of your course, order LaunchPad for Technical Communi- 
cation packaged with the print book at no additional charge. (LaunchPad for 
Technical Communication can also be purchased on its own.) An activation code 
is required. To order LaunchPad for Technical Communication with the print 
book, use ISBN 978-1-319-00982-3. 

Choose from Alternative Formats of Technical Communication 

Bedford/St. Martin’s offers a range of affordable formats, allowing 
students to choose the one that works best for them. For details, visit 
macmillanhighered.com/techcommlle/formats. 

• Bedford e-Book to Go A portable, downloadable e-book is available at 
about half the price of the print book. To order the Bedford e-Book to Go, 
use ISBN 978-1-4576-8849-2. 

• Other Popular e-Book Formats For details, visit macmillanhighered.com 
/ebooks. 
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Select Value Packages 

Add more value to your text by packaging one of the following resources 
with Technical Communication, Eleventh Edition. To learn more about package 
options for any of the products below, contact your Macmillan sales repre- 
sentative or visit macmillanhighered.com/catalog/techcommlle. 

Document-Based Cases for Technical Communication, Second Edition, by 
Roger Munger, Boise State University, offers realistic writing tasks based on 
seven context-rich scenarios, with more than 50 examples of documents that 
students are likely to encounter in the workplace. To order the textbook pack- 
aged with Document-Based Cases for Technical Communication for free, use ISBN 
978-1-319-00980-9. 

Team Writing by Joanna Wolfe, University of Louisville, is a print supple- 
ment with online videos that provides guidelines and examples of collaborat- 
ing to manage written projects by documenting tasks, deadlines, and team 
goals. Two- to five-minute videos corresponding with the chapters in Team 
Writing give students the opportunity to analyze team interactions and learn 
about communication styles. Practical troubleshooting tips show students 
how best to handle various types of conflicts within peer groups. To order the 
textbook packaged with Team Writing, use ISBN 978-1-319-00981-6. 

Instructor Resources 

You have a lot to do in your course. Bedford/St. Martin’s wants to make it 
easy for you to find the support you need — and to get it quickly. 

Computerized Test Bank for Technical Communication, Eleventh Edition, is a 
new test bank that combines — and builds upon — existing assessment resources, 
including the self-assessment quizzes previously available on TechComm Web 
and reading quizzes. The test bank offers a convenient way to provide additional 
assessment to students. Instructors using LaunchPad will find the test bank 
material available in the “Resources” section, where they can add the items they 
wish to their units for the course. The test bank files are also available to down- 
load from the Bedford/St. Martin’s online catalog macmillanhighered.com 
/catalog/techcommlle. 

Instructor’s Resource Manual for Technical Communication, Eleventh 
Edition, is available in the “Resources” section of LaunchPad and as a PDF 
file that can be downloaded from the Bedford/St. Martin’s online catalog 
macmillanhighered.com/catalog/techcommlle. In addition to sample syllabi, 
chapter summaries, and suggested teaching approaches, the Instructor’s 
Resource Manual includes suggested responses to every Document Analysis 
Activity, exercise, and case in the book. The manual also includes a unique 
series of teaching topics. 

Additional Cases and Exercises for every chapter are available in the 
LaunchPad, and you can choose which ones you assign to students. Sug- 
gested responses to each case and exercise are also available. 

Presentation Slides are available to download and adapt for each chapter. 
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THE ELEVENTH EDITION of Technical Communication is organized into five 
parts, highlighting the importance of the writing process in technical com- 
munication and giving equal weight to the development of text and graphics 
in documents and websites. 


PART 

COVERAGE 

Part 1 

Understanding 
the Technical 
Communication 
Environment 

Provides a basic understanding of important topics in technical 
communication, including ethical and legal considerations, the 
role of the writing process in planning and developing technical 
documents, and the practice of collaborating on documents. 

Part 2 

Planning the 
Document 

Focuses on rhetorical concerns, such as considering audience and 
purpose, gathering information through primary and secondary 
research, and planning the organization of documents. 

Part 3 

Developing 
and Testing the 
Verbal and Visual 
Information 

Describes communicating persuasively; writing coherent 
documents; writing effective sentences; designing documents and 
websites; creating graphics; and reviewing, evaluating, and testing 
documents and websites. 

Part 4 

Learning 

Important 

Applications 

Covers a wide range of types of technical communication: letters, 
memos, emails, and microblogs; job-application materials, includ- 
ing print and electronic resumes; proposals; informational reports, 
such as progress and status reports, incident reports, and meeting 
minutes; recommendation reports; lab reports; definitions, 
descriptions, and instructions; oral presentations; and applications 
used in communicating with the public, including newsletters, 
brochures, white papers, podcasts, discussion boards, blogs, and 
wikis. 

Appendix 

Reference 

Handbook 

Offers additional help with skimming sources and taking notes; 
documenting sources using the APA, IEEE, and MLA styles; and 
editing and proofreading documents. Also provides advice to 
multilingual writers on cultural, stylistic, and sentence-level 
communication issues. 
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Technical Communication offers a wealth of support to help you complete 
your technical communication projects: 


Annotated Examples make 
it easier for you to learn from 
the many model documents, 
illustrations, and screen shots 
throughout the text. 


in this excerpt, the left-hand panel uses 
statistics and commonsense evidence to make 
the case that intellectual-property (IP) owners 
should take reasonable measures to protect 
their intellectual property. The federal STOP- 
fakes program is intended to help them do so 


Intellectual Property Rights 



|WiO OBI ■*»! mm* 



The middle panel, which will be the back of 
the brochure when it is folded, briefly describes 
the mission of STOPfakes and provides contact 
information so that IP owners can contact the 
organization (including a quick-response code 
to link directly to the organization's site). 


The right-hand panel, the front of the brochure, 
states the subject (protecting your IP rights) 
and type of document (a step-by-step guide). 
The other three panels not shown here present 
the body of the argument: the step-by-step 
Instructions. 

Many brochures, like 
this one, are made from 
a single page, folded 
Into three panels that 
group Information in 
logical categories. Here 
we see the outside of the 
brochure, with the right- 
hand column presenting 
its title page. Brochures 
are distributed not only 
as paper documents but 
also as PDF (portable 
document format) files 
on organizations' 
websites. 

Throughout, the brochure 
projects a professional 
tone, with direct, under- 
stated language convey- 
ing a strong argument, as 
well as a restrained and 
well-organized presenta- 
tion. For these reasons, 
it is likely to succeed in 
motivating IP owners to 
take advantage of the 
program's resources. 



imbpetMoll"* 1-MMW4M1T 


National IWi Center 1-M6-M-20W 



fl PROTECTING 
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PROPERTY RIGHTS 


* sup- it- stir euitn 
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FIGURE 8.10 Crafting a Professional Image in a Brochure 

A brochure is a brief document used to provide information or to promote something Brochures con describe, for 
example, products produced by a small manufacturer of roofing materials, services offered by a new sports-medicine 
clinic, benefits of joining a particular professional organization or community group, or techniques for choosing 
healthy foods and reducing calories. 

Source. STOPfakes.gov. 2013: wnw Hopfalies gov 's«eydefaullj'(i*es'990 389 ItA Stopiakes bfocriore_ 508 pdt 


Guidelines boxes throughout the book sum- 
marize crucial information and provide strategies 
related to key topics. 
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GUIDELINES 


Designing Easy-To-Read Text 


Follow these three suggestions to make the text on your sites easy to read. 


► Keep the text short. Poor screen resolution makes reading long stretches of text 
difficult. In general, pages should contain no more than two or three screens of 
information. 

► Chunk information. When you write for the screen, chunk information to make it 
easier to understand. Use frequent headings, brief paragraphs, and lists. 

► Make the text as simple as possible. Use common words and short sentences to 
make the Information as simple as the subject allows. 


Ethics Notes in every chapter remind you to 
think about the ethical implications of your 
writing and oral presentations. 


ETHICS NOTE 


ACKNOWLEDGING REVIEWERS RESPONSIBLY 

When you write on the job, take advantage of the expertise of others. It is completely ethical 
to ask subject-matter experts and people who are similar to the intended audience of your 
document to critique a draft of it If your reviewer offers detailed comments and suggestions 
on the draft or sends you a multipage review— and you use some or many of the ideas— you 
are ethically bound to acknowledge that person's contributions. This acknowledgment can 
take the form of a one- or two-sentence statement of appreciation in the Introduction of the 
document or in a transmittal letter. Or you could write a letter or memo of appreciation to the 
reviewer: he or she can then file It and use it for a future performance evaluation. 
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DOCUMENT ANALYSIS ACTIVITY 


Using Multiple Organizational Patterns in an Infographic 


This infographic about how job seekers in England use social media presents three sets of data, each of which uses a different organiza- 
tional pattern. The questions below ask you to think about the organizational patterns. 


1 . On the left. Facebook and Linkedln are 
compared in two pairs of graphics. Is 
the comparison in each pair dear and 
easy to understand? Would other types 
of graphics be easier to understand? 


2. In the middle section of the info- 
graphic which organizational pattern 
is being used? How effective is it in 
helping readers understand the 
information? 


3. What are the two organizational pat- 
terns being used to communicate the 
data in the map of England? 


Document Analysis Activities 

(formerly Interactive Sample Docu- 
ments), located both in print and 
online, allow you to apply what you 
have just read as you analyze a real 
business or technical document. 
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HowTo Use the Styles Group 


As you draft your document, you can use the Styles group 
to apply styles to elements such as headings, lists, and body 
text. Using styles helps to ensure consistency and makes it 
easy to automatically change every instance of a style In your 
document when you revise. 

1 . To apply a style, select the text you want to format, then 
select a style from the Quick Styles gallery in the Styles 
group on the Home tab. 


AaBbCcI 

1 Normal 

AaBbCcI Aab AaBbCc . , j tV. 

T No Spin- rah Submit rdcnongt 

SWa § 
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Subtle Em... Emphasis Interne!... Strong 

Change 

St»ta 4 


can access additional styles by using the up and down 
arrows. 

You can also apply a Quick Style Set to your entire 
document by selecting the Change Styles Icon. 


2. Another way to apply a style is to select the Styles dialog 
box launcher and then select the style you wish to use. 

If you do not see the style options 
you want, select Options to 
display the Style Pane Options 
dialog box. 




® ® 


KEYWORDS: styles, quick style, quick styles gallery, change 
styles, apply a style, apply a different style, styles dialog box 
launcher, style pane options 


Tech Tips for using basic 
software tools give you step-by- 
step, illustrated instructions on 
topics such as tracking changes, 
creating graphics, and modify- 
ing templates. Keywords in each 
Tech Tip help you use the Help 
menu in your word-processing 
software to find additional 
information. 
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Writer's Checklists summarize 
important concepts and act as handy 
reminders as you draft and revise 
your work. 


WRITER'S CHECKLIST 


In planning the document, did you 
analyze your audience? (p. 43) 
analyze your purpose? (p. 43) 
generate ideas about your subject? (p. 44) 
research additional information? (p. 45) 
organize and outline your document? ( p . 46) 
select an application, a design, and a delivery method? 
(p. 47) 

devise a schedule and a budget? (p, 47) 


In drafting the document, did you 

use templates, if appropriate? (p. 48) 
use styles? ( p.St ) 

In revising the draft did you 
LJ study the draft by yourself? (p. 52) 
seek help from others? (p. 53) 

Did you edit the document carefully? (p. 54) 

Did you proofread the document carefully? (p. 54) 


Cases in every chapter present real- 
world writing scenarios built around 
common workplace documents that 
you can critique, download, and revise. 


0| CASE 14: Setting Up and Maintaining a Professional Microblog Account 



As the editor-in-chief of your college newspaper, you have recently been granted 
permission to create a Twitter account. The newspaper's faculty advisor has requested 
that, before you set up the account, you develop a statement of audience and purpose 
based on your school's own social-media policy statement and statements from other 
schools, newspapers, and organizations. To begin putting together a bibliography to 
guide your research and craft your statement, go to "Cases" under "Media* in Ch. 14: 
macmillanhighered.com/launchpad/techcomm11e. 


For quick reference, many of these features are indexed on the last book page 
and inside back cover of this book. 
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What Is Technical Communication? 


THIS TEXTBOOK EXPLORES how people in the working world find, create, and 
deliver technical information. Even if you do not plan on becoming a technical 
communicator (a person whose main job is to produce documents such as 
manuals, reports, and websites), you will often find yourself writing documents 
on your own, participating in teams that write them, and contributing technical 
information for others who read and write them. The purpose of Technical 
Communication is to help you learn the skills you need to communicate more 
effectively and more efficiently in your professional life. 

People in the working world communicate technical information for a number 
of purposes, many of which fall into one of two categories: 

• To help others learn about a subject, carry out a task, or make a decision. For 

instance, the president of a manufacturing company might write an article in 
the company newsletter to explain to employees why management decided to 
phase out production of one of the company's products. Administrators with 
the Social Security Administration might hire a media-production company 
to make a video that explains to citizens how to sign up for Social Security 
benefits. The board of directors of a community-service organization might 
produce a grant proposal to submit to a philanthropic organization in hopes of 
being awarded a grant. 

• To reinforce or change attitudes and motivate readers to take action. A 

wind-energy company might create a website with videos and text intended 
to show that building windmills off the coast of a tourist destination would 
have many benefits and few risks. A property owners' association might 
create a website to make the opposite argument: that the windmills would 
have few benefits but many risks. In each of these two cases, the purpose 
of communicating the information is to persuade people to accept a point 
of view and encourage them to act — perhaps to contact their elected 
representatives and present their views about this public-policy issue. 

Notice that when you communicate in the workplace, you always have a clear 
purpose — what you want to achieve — and an audience — one or more people who 
are going to read the document, attend the oral presentation, visit the website, or 
view the video you produce. 


What IsTechnical Communication? 

Technical information is frequently communicated through documents, such 
as proposals, emails, reports, podcasts, computer help files, blogs, and wikis. 
Although these documents are a key component of technical communica- 
tion, so too is the process: writing and reading tweets and text messages, for 
example, or participating in videoconference exchanges with colleagues. 
Technical communication encompasses a set of activities that people do to 
discover, shape, and transmit information. 

Technical communication begins with listening, speaking, and reading. For 
instance, an executive reads an article about a new kind of computer security 


INTRODUCTION TO TECHNICAL COMMUNICATION 


threat. She doesn’t understand all the details of the threat, but she concludes 
that it could hurt her company’s IT infrastructure. She sets up a meeting 
with her IT supervisor to talk about it, to see whether he knows about it and 
thinks it could be a problem. It turns out that he is aware of the issue and 
has been doing some research about it. The executive asks him to keep going, 
discuss it with his IT colleagues, and contact her next week. 

A week goes by, and the IT supervisor gets back to the executive. He tells 
her that his research suggests the threat is real and serious. She asks him to 
write a recommendation report discussing the nature and scope of the threat 
and presenting a strategy for combatting it. 

How does the IT supervisor begin to write that report? He starts by speak- 
ing with his colleagues in the company and outside of it, and then reading 
discussion boards, blogs, and trade magazines online. Next, he devises a 
plan to have various people in IT draft sections of the report, and he creates 
a schedule for posting their drafts to the company’s online writing space, 
Google Drive, so that all the team members can read and comment on the 
report as it develops. Ten days later, after he and his team have revised, 
edited, and proofread the report, he sends it to the executive. 

But that’s not the end of the story. The executive reads the report and 
agrees with the team’s findings: the company needs to make some changes 
to the IT infrastructure and invest in some new software to combat this seri- 
ous security threat. She decides to meet with her own colleagues to see if 
they agree with her. She points them to the report on the company network 
and sets up a meeting for later that week. 

In short, when you produce technical communication you use the four 
basic communication skills — listening, speaking, reading, and writing — to 
analyze a problem, find and evaluate evidence, and draw conclusions. These 
are the same skills and processes you use when you write in college, and the 
principles you have studied in your earlier writing courses apply to technical 
communication. The biggest difference between technical communication 
and the other kinds of writing you have done is that technical communica- 
tion has a somewhat different focus on audience and purpose. 

In most of your previous academic writing, your audience has been your 
instructor, and your purpose has been to show your instructor that you have 
mastered some body of information or skill. Typically, you have not tried to 
create new knowledge or motivate the reader to take a particular action — 
except to give you an “A” for that assignment. 

By contrast, in technical communication, your audience will likely include 
peers and supervisors in your company, as well as people outside your 
company. Your purpose will likely be to reinforce or change their attitudes 
toward the subject you are writing about, to motivate them to take particular 
actions, or to help them carry out their own work-related tasks. 

For example, suppose you are a public-health scientist working for a fed- 
eral agency. You and your colleagues just completed a study showing that, for 
most adults, moderate exercise provides as much health benefit as strenuous 


The Challenges of Producing Technical Communication 


exercise. After participating in numerous meetings with your colleagues and 
after drafting, critiquing, and revising many drafts, you produce four different 
documents: 

• a journal article for other scientists 

• a press release to distribute to popular print and online publications 

• a blog post and podcast for your agency’s website 

In each of these documents, you present the key information in a different 
way to meet the needs of a particular audience. 

The Challenges of Producing 
Technical Communication 

Most people in the working world don’t look forward to producing technical 
communication. Why? Because it’s hard to do. 

For instance, your supervisor has finally approved your request to buy a 
scanning-electron microscope (SEM) for your department and given you a bud- 
get for buying it. It would be nice if all you had to do now was list the important 
features you need in an SEM, read a couple of articles about SEMs, check off the 
ones that have those features, and then buy the best one that fits your budget. 

Unfortunately, life is not that simple, and neither is technical communica- 
tion. If it were, this book would be about a dozen pages long. 

Technical communication is challenging, and not primarily because SEMs 
are complex devices, although they are. Technical communication is chal- 
lenging because people are complicated, and collaborating with people is at 
the heart of the process. 

As soon as you have decided you need an SEM that can detect signals for 
secondary electrons, for instance, someone on your team argues that you also 
need to detect signals for back-scattered electrons and characteristic X-rays. 
Someone else on the team disagrees, arguing that an SEM that detects those 
additional signals costs an additional $15,000, putting it beyond your budget, 
and that on those rare occasions when you need those functions you can send 
the samples out for analysis. Another team member asks if you’re aware that, 
next year, SEM manufacturers are expected to release products with improved 
signal-detection functions. She thinks, therefore, that the team might want to 
wait until those new models are released. You realize that with the complica- 
tions your colleagues have presented, you won’t be purchasing an SEM any 
time soon. You do more research, keeping their concerns in mind. 

The good news is that there are ways to think about these kinds of com- 
plications, to think through them, that will help you communicate better. No 
matter what document you produce or contribute to, you need to begin by 
considering three sets of factors: 

• Audience-related factors. Does your audience know enough about your 
subject to understand a detailed discussion, or do you need to limit the 
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scope, the amount of technical detail, or the type of graphics you use? 
Does your audience already have certain attitudes or expectations about 
your subject that you wish to reinforce or change? Will the ways in which 
your audience uses your document, or the physical environment in which 
they use it, affect how you write? Does your audience speak English 
well, or should you present the information in several languages? Does 
your audience share your cultural assumptions about such matters as 
the need to spell out details or how to organize the document, or do you 
need to adjust your writing style to match a different set of assumptions? 
Does your audience include people with disabilities (of vision, hearing, 
movement, or cognitive ability) who have needs you want to meet? 

• Purpose-related factors. Before you can write, you need to determine your 
purpose: what do you want your audience to know or believe or do after 
having read your document? Although much technical communication 

is intended to help people perform tasks, such as installing a portable 
hard drive for a computer, many organizations large and small devote 
significant communication resources to branding: creating an image 
that helps customers distinguish the company from competitors. 

Most companies now employ community specialists to coordinate 
the organization’s day-to-day online presence and its social-media 
campaigns. These specialists publicize new products and initiatives and 
respond to new developments and incidents. They also oversee all of the 
organization’s documents — from tweets to blog posts to Facebook fan 
pages and company-sponsored discussion boards. 

• Document-related factors. Does your budget limit the number of people 
you can enlist to help you or limit the size or shape of the document? 

Does your schedule limit how much information you can include in the 
document? Does your subject dictate what kind of document (such as a 
report or a blog post) you choose to write? Does the application call for a 
particular writing style or level of formality? (For the sake of convenience, 

I will use the word document throughout this book to refer to all forms of 
technical communication, from written documents to oral presentations 
and online forms, such as podcasts and wikis.) 

Because all these factors interact in complicated ways, every techni- 
cal document you create involves a compromise. If you are writing a set of 
instructions for installing a water heater and you want those instructions to 
be easily understood by people who speak only Spanish, you will need more 
time and a bigger budget to have the document translated, and it will be 
longer and thus a little bit harder to use, for both English and Spanish speak- 
ers. You might need to save money by using smaller type, smaller pages, and 
cheaper paper, and you might not be able to afford to print it in full color. In 
technical communication, you do the best you can with your resources of 
time, information, and money. The more carefully you think through your 
options, the better able you will be to use your resources wisely and make a 
document that will get the job done. 


Measures of Excellence in Technical Documents 


Characteristics of a Technical Document 

Almost every technical document that gets the job done has six major char- 
acteristics: 

• It addresses particular readers. Knowing who the readers are, what they 
understand about the subject, how well they speak English, and how they 
will use the document will help you decide what kind of document to 
write, how to structure it, how much detail to include, and what sentence 
style and vocabulary to use. 

• It helps readers solve problems. For instance, you might produce a video 
that explains to your company’s employees how to select their employee 
benefits, or a document spelling out the company’s policy on using social 
media in the workplace. 

• It reflects the organization's goals and culture. For example, a state government 
department that oversees vocational-education programs submits an annual 
report to the state legislature in an effort to secure continued funding, as 
well as a lot of technical information to the public in an effort to educate its 
audience. And technical documents also reflect the organization’s culture. For 
example, many organizations encourage their employees to blog about their 
areas of expertise to create a positive image of the organization. 

• It is produced collaboratively. No one person has all the information, skills, 
or time to create a large document. You will work with subject-matter 
experts — the various technical professionals — to create a better document 
than you could have made working alone. You will routinely post 
questions to networks of friends and associates — both inside and outside 
your own organization — to get answers to technical questions. 

• It uses design to increase readability. Technical communicators use design 
features — such as typography, spacing, and color — to make a document 
attractive so that it creates a positive impression, helps readers navigate 
the document, and helps readers understand it. 

• It consists of words or images or both. Images — both static and moving — 
can make a document more interesting and appealing to readers 

and help the writer communicate and reinforce difficult concepts, 
communicate instructions and descriptions of objects and processes, 
communicate large amounts of quantifiable data, and communicate with 
nonnative speakers. 


Measures of Excellence in 
Technical Documents 

Eight characteristics distinguish excellent technical documents: 

• Honesty. The most important measure of excellence in a technical 
document is honesty. You need to tell the truth and not mislead the 
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reader, not only because it is the right thing to do but also because readers 
can get hurt if you are dishonest. Finally, if you are dishonest, you and 
your organization could face serious legal charges. If a court finds that 
your document’s failure to provide honest, appropriate information caused 
a substantial injury or loss, your organization might have to pay millions 
of dollars. 

• Clarity. Your goal is to produce a document that conveys a single meaning 
the reader can understand easily. An unclear technical document can be 
dangerous. A carelessly drafted building code, for example, could tempt 
contractors to use inferior materials or techniques. In addition, an unclear 
technical document is expensive. Handling a telephone call to a customer- 
support center costs $5-10 for a simple question but about $20^5 for a 
more complicated problem — and about a third of the calls are the more 
expensive kind (Carlaw, 2010). Clear technical communication in the 
product’s documentation (its user instructions) can greatly reduce the 
number and length of such calls. 

• Accuracy. A slight inaccuracy can confuse and annoy your readers; a major 
inaccuracy can be dangerous and expensive. In another sense, accuracy 

is a question of ethics. Technical documents must be as objective and 
unbiased as you can make them. If readers suspect that you are slanting 
information — by overstating or omitting facts — they will doubt the validity 
of the entire document. 

• Comprehensiveness. A good technical document provides all the 
information readers need. It describes the background so that readers 
unfamiliar with the subject can understand it. It contains sufficient detail 
so that readers can follow the discussion and carry out any required tasks. 
It refers to supporting materials clearly or includes them as attachments. 

A comprehensive document provides readers with a complete, self- 
contained discussion that enables them to use the information safely, 
effectively, and efficiently. 

• Accessibility. Most technical documents are made up of small, 
independent sections. Because few people will read a document from the 
beginning to the end, your job is to make its various parts accessible. That 
is, readers should not be forced to flip through the pages or click links 
unnecessarily to find the appropriate section. 

• Conciseness. A document must be concise enough to be useful to a 
busy reader. You can shorten most writing by 10 to 20 percent simply 
by eliminating unnecessary phrases, choosing shorter words, and using 
economical grammatical forms. Your job is to figure out how to convey a 
lot of information economically. 

• Professional appearance. You start to communicate before anyone 
reads the first word of the document. If the document looks neat and 
professional, readers will form a positive impression of it and of you. Your 
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document should adhere to the format standards of your organization 
or your professional field, and it should be well designed. For example, 
a letter should follow one of the traditional letter formats and have 
generous margins. 

• Correctness. A correct document is one that adheres to the conventions 
of grammar, punctuation, spelling, mechanics, and usage. Sometimes, 
incorrect writing can confuse readers or even make your writing 
inaccurate. The more typical problem, however, is that incorrect writing 
makes you look unprofessional. If your writing is full of errors, readers will 
wonder if you were also careless in gathering, analyzing, and presenting 
the technical information. If readers doubt your professionalism, they will 
be less likely to accept your conclusions or follow your recommendations. 

Skills and Qualities Shared by 
Successful Workplace Communicators 

People who are good at communicating in the workplace share a number of 

skills and qualities. Four of them relate to the skills you have been honing in 

school and in college: 

• Ability to perform research. Successful communicators know how 
to perform primary research (discovering new information through 
experiments, observations, interviews, surveys, and calculations) and 
secondary research (finding existing information by reading what others 
have written or said). Successful communicators seek out information 
from people who use the products and services, not just from the 
manufacturers. Therefore, although successful communicators would visit 
the Toyota website to learn about the technical specifications of a Prius if 
they wanted to find out what it is like to drive, own, or repair a Prius, they 
would be sure to search the Internet for information from experts not 
associated with Toyota, as well as user-generated content: information from 
owners, presented in forums such as discussion boards and blogs. 

• Ability to analyze information. Successful communicators know how 
to identify the best information — most accurate, relevant, recent, and 
unbiased — and then figure out how it helps in understanding a problem 
and ways to solve it. Successful communicators know how to sift through 
mountains of data, identifying relationships between apparently unrelated 
facts. They know how to evaluate a situation, look at it from other people’s 
perspectives, and zero in on the most important issues. 

• Ability to solve problems. Successful communicators know how to break 
big problems into smaller ones, figure out what isn’t working right, and 
identify and assess options for solving the problems. They know how to 
compare and contrast the available options to achieve the clearest, most 
objective understanding of the situation. 
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• Ability to speak and write clearly. Successful communicators know how 
to express themselves clearly and simply, both to audiences that know 
a lot about the subject and to audiences that do not. They take care 

to revise, edit, and proofread their documents so that the documents 
present accurate information, are easy to read, and make a professional 
impression. And they know how to produce different types of documents, 
from tweets to memos to presentations. 

In addition to the skills just described, successful workplace communicators 

have seven qualities that relate to professional attitudes and work habits: 

• They are honest. Successful communicators tell the truth. They don’t 
promise what they know they can’t deliver, and they don’t bend facts. 
When they make mistakes, they admit them and work harder to solve the 
problem. 

• They are willing to learn. Successful communicators know that they 
don’t know everything — not about what they studied in college, what 
their company does, or how to write and speak. Every professional is a 
lifelong learner. 

• They display emotional intelligence. Because technical communication 
usually calls for collaboration, successful communicators understand 
their own emotions and those of others. Because they can read people — 
through body language, facial expression, gestures, and words — they can 
work effectively in teams, helping to minimize interpersonal conflict and 
encouraging others to do their best work. 

• They are generous. Successful communicators reply to requests for 
information from colleagues inside and outside their own organizations, 
and they share information willingly. (Of course, they don’t share 
confidential information, such as trade secrets, information about new 
products being developed, or personal information about colleagues.) 

• They monitor the best information. Successful communicators seek 
out opinions from others in their organization and in their industry. 

They monitor the best blogs, discussion boards, and podcasts for new 
approaches that can spark their own ideas. They use tools such as RSS 
(really simple syndication or rich site summary, a utility that notifies users 
when new content appears on sites they follow) to help them stay on top 
of the torrent of new information on the Internet. They know how to use 
social media and can represent their organization online. 

• They are self-disciplined. Successful communicators are well organized 
and diligent. They know, for instance, that proofreading an important 
document might not be fun but is always essential. They know that when 
a colleague asks a simple technical question, answering the question 
today — or tomorrow at the latest — is more helpful than answering it in 

a couple of weeks. They finish what they start, and they always do their 
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best on any document, from the least important text message to the most 
important report. 

• They can prioritize and respond quickly. Successful communicators 
know that the world doesn’t always conform to their own schedules. 
Because social media never sleep, communicators sometimes need to 
put their current projects aside in order to respond immediately when 
a stakeholder reports a problem that needs prompt action or publishes 
inaccurate information that can hurt the organization. And even though 
speed is critically important, they know that quality is, too; therefore, they 
make sure every document is fully professional before it goes out. 


How Communication Skills and 
Qualities Affect Your Career 

Many college students believe that the most important courses they take 
are those in their major. Some biology majors think, for example, that if 
they just take that advanced course in genetic analysis, employers will con- 
clude that they are prepared to do more-advanced projects and therefore 
hire them. 

Therefore, many college students are surprised to learn that what employ- 
ers say they are looking for in employees are the communication skills and 
qualities discussed in the previous section. Surveys over the past three or 
four decades have shown consistently that employers want people who can 
communicate. Look at it this way: when employers hire a biologist, they want 
a person who can communicate effectively about biology. When they hire a 
civil engineer, they want a person who can communicate about civil engi- 
neering. 

A 2012 survey by Millennial Branding, a research and management con- 
sulting firm that helps companies find and train Generation Y employees, 
sifted data from more than 100,000 U.S. companies. The results showed that 
98 percent of those companies named communication skills as extremely 
important for new employees (Millennial Branding, 2012). The next two most 
important characteristics? Having a positive attitude (97 percent) and team- 
work skills (92 percent). 

Job Outlook 2013, a report produced by the National Association of Col- 
leges and Employers, found that communication skills, teamwork skills, and 
problem-solving skills top the list of skills and qualities that employers seek. 
Their main conclusion: “. . . the ideal candidate is a good communicator 
who can make decisions and solve problems while working effectively in a 
team” (National Association, 2012, p. 31). On a 5-point scale, where 5 equals 
“extremely important,” here are the top ten skills and qualities, according to 
employers, and the scores they earned: 
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SKILL OR ABILITY 

SCORE 

Ability to verbally communicate with persons inside and outside the 
organization 

4.63 

Ability to work in a team structure 

4.60 

Ability to make decisions and solve problems 

4.51 

Ability to plan, organize, and prioritize work 

4.46 

Ability to obtain and process information 

4.43 

Ability to analyze quantitative data 

4.30 

Technical knowledge related to the job 

3.99 

Proficiency with computer software programs 

3.95 

Ability to create and/or edit written reports 

3.56 

Ability to sell or influence others 

3.55 


Most of these skills relate back to the previous discussion about the impor- 
tance of process in technical communication. 

A study of more than 100 large American corporations, which together 
employ 8 million people, suggests that writing is a more important skill for 
professionals today than it ever has been (College Entrance Examination 
Board, 2004, pp. 3-4). TWo-thirds of professionals need strong writing skills in 
their daily work. Fifty percent of all companies in all industries consider writ- 
ing skills in making promotion decisions. And almost half of the largest U.S. 
companies offer or require training for professionals who cannot write well 
(College Entrance Examination Board, 2004, p. 4). These companies spend, on 
average, $900 per employee for writing training. Would a company rather not 
have to spend that $900? Yes. 

You’re going to be producing and contributing to a lot of technical docu- 
ments, not only in this course but also throughout your career. The facts of 
life in the working world are simple: the better you communicate, the more 
valuable you are. This textbook can help you learn and practice the skills that 
will make you a better communicator. 


A Look at Three Technical Documents 

Figures 1.1, 1.2 (page 14), and 1.3 (page 15) present excerpts from technical 
documents. Together, they illustrate a number of the ideas about technical 
communication discussed in this chapter. 
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Energy 101: Concentrating Solar Power 


/And the steam is also cooled, condensed and 
recycled again and again. One big advantage 


o urn [ ] 


The video takes advantage of our 
cultural assumptions about color: 
red suggests heat, blue suggests 
cold. 


The video includes a text-only 
version that provides a complete 
transcript of the narration and 
describes the images. 


This screen from a video produced 
by the Department of Energy is 
intended to educate the general 
public about the basics of solar 
energy. Because it includes narra- 
tion, still images, video, and anima- 
tion, creating it required the efforts 
of many professionals. 

The video is meant to be easy to 
share on social media. 


The video was designed to accom- 
modate people with disabilities: the 
viewer can listen to the narration or 
turn on the subtitles. 


FIGURE 1 .1 A Video That Educates the Public About a Technical Subject 

Source: U.S. Department of Energy, 2012: http://energy.gov/articles/energy-101-concentrating-solar-power. 
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Through our current campaign. Our Common Waters, and with 
exposure to increased oil and gas development near our homes and 
communities, we have grown concerned about hydraulic fracturing 
(commonly called "fracking") and its impact on water, air, soil, wildlife 
habitat, and human health. Over 90% of oil and gas wells in the U.S. 
use fracking to aid in extraction, and many fracking fluids and 
chemicals are known toxins for humans and wildlife. 

For decades, natural gas (methane) deposits were tapped by single 
wells drilled vertically over large, free- flowing pockets of gas. Then 
came fracking, a water- and chemical- intensive method that promised 
the profitable extraction of natural gas trapped in shale. 


Fracking In Our Backyard 


■ 


John Jennings said.. 


Fracking should be regulated but consider that it’s 
actuaBy less risky and produces a cleaner method of 
energy than coal. Until we get away from fossH fuels, 
fracking is a smart technology that allows America to 
decrease dependence on foreign oil, whfle also produces 
the cleanest fossil fuel we know. Natural gas and 
fracking isn't the permanent solution, but it is a better 
in between step. 

Jvb: A U 2013-81 


R said in reply to John Jennings... 

SSS Sorry John, but we will never be able to completely get 

away from fossil fuels. Not going to happen. 

Ssriar PvIy II. 291? g t 0 ?»? 1 W 


Andrew H. said... 


Fracking is the best thing to happen to this country 
since the manufacturing boom of world war II. It’s 
improving this country in so many good ways. It's 
bringing a lot of money and jobs... so maybe people can 
finally afford to buy patagonia clothes. 

Reply 


The post generated many comments, of which the 
first three are presented here. Notice that the third 
comment ends with a swipe at the company. Blogs are 
a popular way for organizations to interact with their 
stakeholders, and even though blog posts routinely 
elicit negative comments, most organizations believe 
that the occasionally embarrassing or critical comment 
is a reasonable price to pay for the opportunity to gen- 
erate honest discussions about issues — and thereby 
learn what is on the minds of their stakeholders. 

to educate its readers about the controversy sur- 
rounding hydraulic fracturing. The post included links 
to many online sources about the controversy and 
presented the company's perspective: "Because of 
fracking's wide-ranging risks and impacts, we support 
each community's right to educate itself and regulate 
and/or ban fracking, and we support local, state and 
federal government efforts to monitor and regulate 
fracking." 


Patagonia, the manufacturer of outdoor clothing, 
hosts a blog called The Cleanest Line. In one recent 
post, "Fracking In Our Backyard, "the company sought 


FIGURE 1.2 A Corporate Blog Post Presenting a Public-Policy Viewpoint 

Source: Patagonia, 2013: http://www.thecleanestline.eom/2013/07/fracking-in-our-backyard.html#more. Reprinted by permission of The Cleanest Line. 
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The history of this graphic says 
something about how information 
flows in the digital age. The graphic 
was originally created by one per- 
son, Manny Wilson of U.S. Central 
Command, who shared it with a 
colleague at another U.S. govern- 
ment agency. Eventually, it made its 
way to another person, Anthony D. 
Williams, who incorporated it into a 
presentation he delivered at a cor- 
poration. From there, it went viral. 


The writer who created this image 
doesn't need to say that a wiki is a 
better tool than email for editing a 
document. The complexity of the 
image on the left, compared with 
the simplicity of the image on the 
right, shows why the wiki is the 
better tool for this job. 


One characteristic that distin- 
guishes technical communication 
from many other kinds of writing is 
its heavy use of graphics to clarify 
concepts and present data. This 
graphic, from a PowerPoint presen- 
tation, compares two technologies 
used for collaborative writing. The 
image on the left represents how a 
writer creates a document and then 
distributes it via email to others 
for editing. The image on the right 
represents how a writer creates 
a document in a wiki (an online 
writing and editing space), to which 
others come to view and edit the 
document. 


FIGURE 1.3 A Graphic Comparing Two Communication Media 

Source: Williams, 2008: http://www.wikinomics.com/blog/index.php/2008/03/26/wiki-collaboration-leads-to-happiness/. 
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EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1. Form small groups and study the home page of 
your college or university's website. Focus on three 
measures of excellence in technical communication: 
clarity, accessibility, and professional appearance. Flow 
effectively does the home page meet each of these 
measures of excellence? Be prepared to share your 
findings with the class. 

2. Locate an owner's manual for a consumer product, 
such as a coffee maker, bicycle, or hair dryer. In a memo 
to your instructor, discuss two or three decisions the 
writers and designers of the manual appear to have 


made to address audience-related factors, purpose- 
related factors, or document-related factors. For 
instance, if the manual is printed only in English, the 
writers and designers presumably decided that they 
didn't have the resources to create versions in other 
languages. 

3. Using a job site such as lndeed.com or Monster 

.com, locate three job ads for people in your academic 
major. In each ad, identify references to writing and 
communication skills, and then identify references to 
professional attitudes and work habits. Be prepared to 
share your findings with the class. 


For more practice with the concepts covered in Chapters 1 -4, 
la complete the LearningCurve activity "Understanding the 
Technical Communication Environment" under "Additional Resources" 

in Ch. 1: macmillanhighered.com/launchpad/techcomm11e. 


j|CASE 1: Using the Measures of Excellence in Evaluating a Resume 



Your technical-communication instructor is planning to invite guest speakers to deliver 
presentations to the class on various topics throughout the semester, and she has asked 
you to work with one of them to tailor his job-application presentation to the "Measures 
of Excellence" discussed in this chapter. To access relevant documents and get started on 
your project, go to"Cases"under"Additional Resources"in Ch. 1 : macmillanhighered.com 
/launchpad/techcomm 1 1 e. 
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ETHICAL AND LEGAL ISSUES are all around you in your work life. If you look at 
the website of any bike manufacturer, for example, you will see that bicyclists are 
always shown wearing helmets. Is this because bike manufacturers care about 
safety? Certainly. But bike makers also care about product liability. If a company 
website showed cyclists without helmets, an injured cyclist might sue, claiming 
that the company was suggesting it is safe to ride without a helmet. 

Ethical and legal pitfalls lurk in the words and graphics of many kinds of formal 
documents. In producing a proposal, you might be tempted to exaggerate or lie 
about your organization's past accomplishments, pad the resumes of the project 
personnel, list as project personnel some workers who will not be contributing 
to the project, or present an unrealistically short work schedule. In drafting 
product information, you might feel pressured to exaggerate the quality of the 
products shown in catalogs or manuals or to downplay the hazards of using those 
products. In creating graphics, you might be asked to hide an item's weaknesses 
by manipulating a photo of a product. 

One thing is certain: there are many serious ethical and legal issues related to 
technical communication, and all professionals need a basic understanding of them. 


A Brief Introduction to Ethics 

Ethics is the study of the principles of conduct that apply to an individual or 
a group. For some people, ethics is a matter of intuition — what their gut feel- 
ings tell them about the rightness or wrongness of an act. Others see ethics 
in terms of their own religion or the Golden Rule: treat others as you would 
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like them to treat you. Ethicist Manuel G. Velasquez outlines four moral stan- 
dards that are useful in thinking about ethical dilemmas (2011): 

• Rights. This standard concerns individuals’ basic needs and welfare. 
Everyone agrees, for example, that people have a right to a reasonably 
safe workplace. When we buy a product, we have a right to expect that 
the information that accompanies it is honest and clear. However, not 
everything that is desirable is necessarily a right. For example, in some 
countries, high-quality health care is considered a right. That is, the 
government is required to provide it, regardless of whether a person can 
afford to pay for it. In other countries, health care is not considered a right. 

• Justice. This standard concerns how the costs and benefits of an action 
or a policy are distributed among a group. For example, the cost of 
maintaining a high-speed broadband infrastructure should be borne, in 
part, by people who use it. However, because everyone benefits from the 
infrastructure, the standard of justice suggests that general funds can also 
be used to pay for it. Another example: justice requires that people doing 
the same job receive the same pay, regardless of whether they are male or 
female, black or white. 

• Utility. This standard concerns the positive and negative effects that an 
action or a policy has, will have, or might have on others. For example, if 
a company is considering closing a plant, the company’s leaders should 
consider not only the money they would save but also the financial 
hardship of laid-off workers and the economic effects on the community. 
One tricky issue in thinking about utility is figuring out the time frame to 
examine. An action such as laying off employees can have one effect in 
the short run — improving the company’s quarterly balance sheet — and a 
very different effect in the long run — hurting the company’s productivity 
or the quality of its products. 

• Care. This standard concerns the relationships we have with other 
individuals. We owe care and consideration to all people, but we have 
greater responsibilities to people in our families, our workplaces, and our 
communities. The closer a person is to us, the greater care we owe that 
person. Therefore, we have greater obligations to members of our family 
than we do to others in our community. 

Although these standards provide a vocabulary for thinking about how 
to resolve ethical conflicts, they are imprecise and often conflict with each 
other. Therefore, they cannot provide a systematic method of resolving ethi- 
cal conflicts. Take the case of a job opportunity in your company. You are a 
member of the committee that will recommend which of six applicants to 
hire. One of the six is a friend of yours who has been unable to secure a pro- 
fessional job since graduating from college two years ago. She therefore does 
not have as much relevant workplace experience as the other five candidates. 
However, she is enthusiastic about gaining experience in this particular 
field — and eager to start paying off her student loans. 



20 


2 


UNDERSTANDING ETHICAL AND LEGAL CONSIDERATIONS 


How can the four standards help you think through the situation? Accord- 
ing to the rights standard, lobbying for your friend or against the other appli- 
cants would be wrong because all applicants have an ethical right to an eval- 
uation process that considers only their qualifications to do the job. Looking 
at the situation from the perspective of justice yields the same conclusion: it 
would be wrong to favor your friend. From the perspective of utility, lobbying 
for your friend would probably not be in the best interests of the organiza- 
tion, although it might be in your friend’s best interests. Only according to 
the care standard does lobbying for your friend seem reasonable. 

As you think about this case, you have to consider a related question: 
should you tell the other people on the hiring committee that one of the 
applicants is your friend? Yes, because they have a right to know about your 
personal relationship so that they can better evaluate your contributions to 
the discussion. You might also offer to recuse yourself (that is, not participate 
in the discussion of this position), leaving it to the other committee members 
to decide whether your friendship with a candidate represents a conflict of 
interest. 

One more complication in thinking about this case: Let’s say your friend is 
one of the top two candidates for the job. In your committee, which is made 
up of seven members, three vote for your friend, but four vote for the other 
candidate, who already has a very good job. She is a young, highly skilled 
employee with degrees from prestigious universities. In other words, she is 
likely to be very successful in the working world, regardless of whether she 
is offered this particular job. Should the fact that your friend has yet to 
start her own career affect your thinking about this problem? Some people 
would say no: the job should be offered to the most qualified applicant. 
Others would say yes: society does not adequately provide for its less- 
fortunate members, and because your friend needs the job more and is 
almost as qualified as the other top applicant, she should get the offer. In 
other words, some people would focus on the narrow, technical question of 
determining the best candidate for the job, whereas others would see a much 
broader social question involving human rights. 

Most people do not explore the conflict among rights, justice, utility, and 
care when they confront a serious ethical dilemma; instead, they simply 
do what they think is right. Perhaps this is good news. However, the depth 
of ethical thinking varies dramatically from one person to another, and the 
consequences of superficial ethical thinking can be profound. For these rea- 
sons, ethicists have described a general set of principles that can help people 
organize their thinking about the role of ethics within an organizational 
context. These principles form a web of rights and obligations that connect 
an employee, an organization, and the world in which the organization is 
situated. 

For example, in exchange for their labor, employees enjoy three basic 
rights: fair wages, safe and healthy working conditions, and due process in 
the handling of such matters as promotions, salary increases, and firing. 
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Although there is still serious debate about the details of employee rights, 
such as whether they have the right to freedom from surreptitious surveil- 
lance and unreasonable searches in drug investigations, the debate almost 
always concerns the extent of employees’ rights, not the existence of the 
basic rights themselves. For instance, ethicists disagree about whether hiring 
undercover investigators to identify drug users at a job site is an unwar- 
ranted intrusion on employees’ rights, but there is no debate about employ- 
ees’ right to freedom from unwarranted intrusion. 

Your Ethical Obligations 

In addition to enjoying rights, an employee assumes obligations, which can 
form a clear and reasonable framework for discussing the ethics of technical 
communication. The following discussion outlines three sets of obligations 
that you have as an employee: to your employer, to the public, and to the 
environment. 

OBLIGATIONS TO YOUR EMPLOYER 

You are hired to further your employer’s legitimate aims and to refrain from 
any activities that run counter to those aims. Specifically, you have five obli- 
gations: 

• Competence and diligence. Competence refers to your skills; you should 
have the training and experience to do the job adequately. Diligence simply 
means hard work. Unfortunately, in a recent survey of 10,000 workers, 
the typical worker wastes nearly two hours of his or her eight-hour 

day surfing the web, socializing with co-workers, and doing other tasks 
unrelated to his or her job (Malachowski, 2013). 

• Generosity. Although generosity might sound like an unusual obligation, 
you are obligated to help your co-workers and stakeholders outside your 
organization by sharing your knowledge and expertise. What this means 
is that if you are asked to respond to appropriate questions or provide 
recommendations on some aspect of your organization’s work, you 
should do so. If a customer or supplier contacts you, make the time to 
respond helpfully. Generosity shows professionalism and furthers your 
organization’s goals. 

• Honesty and candor. You should not steal from your employer. Stealing 
includes such practices as embezzlement, “borrowing” office supplies, and 
padding expense accounts. Candor means truthfulness; you should report 
to your employer problems that might threaten the quality or safety of the 
organization’s product or service. 

Issues of honesty and candor include what Sigma Xi, the Scientific 
Research Society, calls trimming, cooking, and forging (Sigma Xi, 2000, 
p. 11). Trimming is the smoothing of irregularities to make research data 
look extremely accurate and precise. Cooking is retaining only those results 
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that fit the theory and discarding the others. And forging is inventing 
some or all of the data or even reporting experiments that were never 
performed. In carrying out research, employees must resist any pressure 
to report only positive findings. 

• Confidentiality. You should not divulge company business outside of 
the company. If a competitor finds out that your company is planning 
to introduce a new product, it might introduce its own version of that 
product, robbing you of your competitive advantage. Many other kinds 
of privileged information — such as information on quality-control 
problems, personnel matters, relocation or expansion plans, and financial 
restructuring — also could be used against the company. A well-known 
confidentiality problem involves insider information: an employee who 
knows about a development that will increase (or decrease) the value 

of the company’s stock, for example, buys (or sells) the stock before the 
information is made public, thus unfairly — and illegally — reaping a profit 
(or avoiding a loss). 

• Loyalty. You should act in the employer’s interest, not in your own. 
Therefore, it is unethical to invest heavily in a competitor’s stock, because 
that could jeopardize your objectivity and judgment. For the same reason, 
it is unethical (and illegal) to accept bribes or kickbacks. It is unethical to 
devote considerable time to moonlighting (performing an outside job, such 
as private consulting), because the outside job could lead to a conflict of 
interest and because the heavy workload could make you less productive 
in your primary position. However, you do not owe your employer absolute 
loyalty; if your employer is acting unethically, you have an obligation to try 
to change that behavior — even, if necessary, by blowing the whistle. 

OBLIGATIONS TO THE PUBLIC 

Every organization that offers products or provides services is obligated to 
treat its customers fairly. As a representative of an organization, and espe- 
cially as an employee communicating technical information, you will fre- 
quently confront ethical questions. 

In general, an organization is acting ethically if its product or service is 
both safe and effective. The product or service must not injure or harm the 
consumer, and it must fulfill its promised function. However, these com- 
monsense principles provide little guidance in dealing with the complicated 
ethical problems that arise routinely. 

According to the U.S. Consumer Product Safety Commission (2011), more 
than 4,500 deaths and 14 million injuries occur each year in the United States 
because of consumer products — not counting automobiles and medications. 
Even more common, of course, are product and service failures: products 
or services don’t do what they are supposed to do, products are difficult to 
assemble or operate, they break down, or they require more expensive main- 
tenance than the product information indicates. 
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Who is responsible for injuries and product failures: the company that 
provides the product or service or the consumer who purchases it? In indi- 
vidual cases, blame is sometimes easy enough to determine. A person who 
operates a chainsaw without reading the safety information and without 
seeking any instruction in how to use it is to blame for any injuries caused 
by the normal operation of the saw. But a manufacturer that knows that the 
chain on the saw is liable to break under certain circumstances and fails to 
remedy this problem or warn the consumer is responsible for any resulting 
accidents. 

Unfortunately, these principles do not outline a rational theory that can 
help companies understand how to act ethically in fulfilling their obliga- 
tions to the public. Today, most court rulings are based on the premise 
that the manufacturer knows more about its products than the consumer 
does and therefore has a greater responsibility to make sure the products 
comply with all of the manufacturer’s claims and are safe. Therefore, in 
designing, manufacturing, testing, and communicating about a product, 
the manufacturer has to make sure the product will be safe and effective 
when used according to the instructions. However, the manufacturer is 
not liable when something goes wrong that it could not have foreseen or 
prevented. 

OBLIGATIONS TO THE ENVIRONMENT 

One of the most important lessons we have learned in recent decades is that 
we are polluting and depleting our limited natural resources at an unac- 
ceptably high rate. Our excessive use of fossil fuels not only deprives future 
generations of them but also causes possibly irreversible pollution problems, 
such as global warming. Everyone — government, businesses, and individu- 
als — must work to preserve the environment to ensure the survival not only 
of our own species but also of the other species with which we share the 
planet. 

But what does this have to do with you? In your daily work, you prob- 
ably do not cause pollution or deplete the environment in any extraordi- 
nary way. Yet you will often know how your organization’s actions affect 
the environment. For example, if you work for a manufacturing company, 
you might be aware of the environmental effects of making or using your 
company’s products. Or you might help write an environmental impact 
statement. 

As communicators, we should treat every actual or potential occurrence 
of environmental damage seriously. We should alert our supervisors to the 
situation and work with them to try to reduce the damage. The difficulty, 
of course, is that protecting the environment can be expensive. Clean fuels 
usually cost more than dirty ones. Disposing of hazardous waste properly 
costs more (in the short run) than merely dumping it. Organizations that 
want to reduce costs may be tempted to cut corners on environmental 
protection. 
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Your Legal Obligations 

Although most people believe that ethical obligations are more comprehen- 
sive and more important than legal obligations, the two sets of obligations 
are closely related. Our ethical values have shaped many of our laws. For this 
reason, professionals should know the basics of four different bodies of law: 
copyright, trademark, contract, and liability. 

COPYRIGHT LAW 

As a student, you are frequently reminded to avoid plagiarism. A student 
caught plagiarizing would likely fail the assignment and possibly the course 
and might even be expelled from school. A medical researcher or a reporter 
caught plagiarizing would likely be fired or at least find it difficult to publish 
in the future. But plagiarism is an ethical, not a legal, issue. Although a pla- 
giarist might be expelled from school or be fired, he or she will not be fined 
or sent to prison. 

By contrast, copyright is a legal issue. Copyright law is the body of law 
that relates to the appropriate use of a person’s intellectual property: written 
documents, pictures, musical compositions, and the like. Copyright literally 
refers to a person’s right to copy the work that he or she has created. 

The most important concept in copyright law is that only the copyright 
holder — the person or organization that owns the work — can copy it. For 
instance, if you work for Zipcar, you can legally copy information from the 
Zipcar website and use it in other Zipcar documents. This reuse of informa- 
tion is routine in business, industry, and government because it helps ensure 
that the information a company distributes is both consistent and accurate. 

However, if you work for Zipcar, you cannot simply copy information that 
you find on the Car2Go website and put it in Zipcar publications. Unless you 
obtained written permission from Car2Go to use its intellectual property, you 
would be infringing on Car2Go’s copyright. 

Why doesn’t the Zipcar employee who writes the information for Zipcar 
own the copyright to that information? The answer lies in a legal concept 
known as work made for hire. Anything written or revised by an employee on 
the job is the company’s property, not the employee’s. 

Although copyright gives the owner of the intellectual property some 
rights, it doesn’t give the owner all rights. You can place small portions of 
copyrighted text in your own document without getting formal permission 
from the copyright holder. When you quote a few lines from an article, for 
example, you are taking advantage of a part of copyright law called fair use. 
Under fair-use guidelines, you have the right to use a portion of a published 
work, without getting permission, for purposes such as criticism, commen- 
tary, news reporting, teaching, scholarship, or research. Because fair use is 
based on a set of general guidelines that are meant to be interpreted on a 
case-by-case basis, you should still cite the source accurately to avoid poten- 
tial plagiarism. 
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GUIDELINES 


Determining Fair Use 


Courts consider four factors in disputes over fair use: 


► The purpose and character of the use, especially whether the use is for profit. 

Profit-making organizations are scrutinized more carefully than nonprofits. 

► The nature and purpose of the copyrighted work. When the information is es- 
sential to the public — for example, medical information — the fair-use principle is 
applied more liberally. 

► The amount and substantiality of the portion of the work used. A 200-word 
passage would be a small portion of a book but a large portion of a 500-word 
brochure. 

► The effect of the use on the potential market for the copyrighted work. Any use 

of the work that is likely to hurt the author's potential to profit from the original 
work would probably not be considered fair use. 


A new trend is for copyright owners to stipulate which rights they wish to 
retain and which they wish to give up. You might see references to Creative 
Commons, a not-for-profit organization that provides symbols for copyright 
owners to use to communicate their preferences. Figure 2.1 shows four of the 
Creative Commons symbols. 




Attribution. You must attribute the work in the manner specified 
by the author or licensor (but not in any way that suggests that they 
endorse you or your use of the work). 


Noncommercial. You may not use this work for commercial pur- 
poses. 


® 


No Derivative Works. You may not alter, transform, or build upon 
this work. 




Share Alike. If you alter, transform, or build upon this work, 
you may distribute the resulting work only under the same or similar 
license to this one. 


FIGURE 2.1 Selected Licensing Symbols from Creative Commons 

The organization has created a number of symbols to represent rights that copyright owners can retain or 
surrender. 

Licensed under Creative Commons Attribution 3.0 License, http://creativecommons.Org/licenses/by/3.0/. 





26 


2 


UNDERSTANDING ETHICAL AND LEGAL CONSIDERATIONS 


For more about documenting your 
sources, see Appendix, Part B. 


4 \ 


GUIDELINES 


Dealing with Copyright Questions 


Consider the following advice when using material from another source. 


► Abide by the fair-use concept. Do not rely on excessive amounts of another 
source's work (unless the information is your company's own boilerplate). 

► Seek permission. Write to the source, stating what portion of the work you wish 
to use and the publication you wish to use it in. The source is likely to charge you 
for permission. 

► Cite your sources accurately. Citing sources fulfills your ethical obligation and 
strengthens your writing by showing the reader the range of your research. 

► Consult legal counsel if you have questions. Copyright law is complex. Don't rely 
on instinct or common sense. 


ETHICS NOTE 


DISTINGUISHING PLAGIARISM FROM 
ACCEPTABLE REUSE OF INFORMATION 

Plagiarism is the act of using someone else's words or ideas without giving credit to the origi- 
nal author. It doesn't matter whether the writer intended to plagiarize. Obviously, it is plagia- 
rism to borrow or steal graphics, video or audio media, written passages, or entire documents 
and then use them without attribution. Web-based sources are particularly vulnerable to pla- 
giarism, partly because people mistakenly think that if information is on the web it is free to 
borrow and partly because this material is so easy to copy, paste, and reformat. 

However, writers within a company often reuse one another's information without giving 
credit — and it is completely ethical. For instance, companies publish press releases when 
they wish to publicize news. These press releases typically conclude with descriptions of the 
company and how to get in touch with an employee who can answer questions about the 
company's products or services. These descriptions, sometimes called boilerplate, are simply 
copied and pasted from previous press releases. Because these descriptions are legally the 
intellectual property of the company, reusing them in this way is completely honest. Similarly, 
companies often repurpose their writing. That is, they copy a description of the company from 
a press release and paste it into a proposal or an annual report. This reuse also is acceptable. 
When you are writing a document and need a passage that you suspect someone in your 
organization might already have written, ask a more-experienced co-worker whether the cul- 
ture of your organization permits reusing someone else's writing. If the answer is yes, check 
with your supervisor to see whether he or she approves of what you plan to do. 


TRADEMARK LAW 

Companies use trademarks and registered trademarks to ensure that the public 
recognizes the name or logo of a product. 

• A trademark is a word, phrase, name, or symbol that is identified with a 
company. The company uses the ™ symbol after the product name to 
claim the design or device as a trademark. However, using this symbol 
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does not grant the company any legal rights. It simply sends a message to 
other organizations that the company is claiming a trademark. 

• A registered trademark is a word, phrase, name, or symbol that the company 
has registered with the U.S. Patent and Trademark Office. The company 
can then use the ® symbol after the trademarked item. Registering a 
trademark, a process that can take years, ensures much more legal 
protection than a simple trademark throughout the United States, as well 
as in other nations. Although a company is not required to use the symbol, 
doing so makes it easier to take legal action against another organization 
that it believes has infringed on its trademark. 

All employees are responsible for using trademark and registered trademark 
symbols accurately when referring to a company’s products. 


A 


GUIDELINES 


Protecting Trademarks 


Use the following techniques to protect your client's or employer's trademark. 


► Distinguish trademarks from other material. Use boldface, italics, a different 
typeface, a different type size, or a different color to distinguish the trademarked 
item. 

► Use the trademark symbol. At least once in each document — preferably the first 
time the name or logo appears — use the appropriate symbol after the name or 
logo, followed by an asterisk. At the bottom of the page, include a statement 
such as the following: "*COKE is a registered trademark of the Coca-Cola Com- 
pany." 

► Use the trademarked item's name as an adjective, not as a noun or verb. Trade- 
marks can become confused with the generic term they refer to. Use the trade- 
marked name along with the generic term, as in Xerox® photocopier or LaserJet® 
printer. 

does not protect trademark buy th ree LaserJets® 

protects trademark buy three LaserJet® printers 

► Do not use the possessive form of the trademarked name. Doing so reduces 
the uniqueness of the item and encourages the public to thinkof the term as 
generic. 

does not protect trademark iPad's® fine quality 

protects trademark the fine quality of iPad® tablets 


CONTRACT LAW 

Contract law deals with agreements between two parties. In most cases, 
disputes concern whether a product lives up to the manufacturer’s claims. 
These claims take the form of express warranties or implied warranties. 

An express warranty is a written or oral statement that the product has a 
particular feature or can perform a particular function. For example, a state- 
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<§) 

AWARNING 

Magnetic fields present. 
Pacemaker wearers 
should remain at 
least 1 foot away from 
this device. 

SLSOL.COM 800-226-0642 No. C7003-38WHYD 


FIGURE 2.2 A Warning Label 

This warning label uses symbols — such as the orange box, 
the red circle with the slash, and the image of the heart 
and pacemaker — and words to visually and verbally warn 
people with pacemakers to stay away from a device that 
can hurt them. The warning helps the company do the 
right thing — and avoid product-liability lawsuits. 


ment in a printer manual that the printer produces 
17 pages per minute is an express warranty. An implied 
warranty is one of two kinds of non-written guaran- 
tees: 

• The merchantability warranty guarantees that the 
product is of at least average quality and appropriate 
for the ordinary purposes it was intended to serve. 

• The fitness warranty guarantees that the product is 
suitable for the buyer’s purpose if the seller knows 
that purpose. For example, if a car salesperson knows 
that a buyer wishes to pull a 5,000-pound trailer but 
also knows that a car cannot pull such a load, the 
salesperson is required to inform the buyer of this fact. 

LIABILITY LAW 


Source: Safety Label Solutions, 2013: http://www.safetylabelsolutions.com 
/C7003-38_c_1 79.html. Courtesy of Safety Label Solutions, Inc. 


Under product-liability law, a manufacturer or seller 
of a product is liable for injuries or damages caused 
by the use of that product. Liability is an important 
concern for communicators, because courts frequently rule that manufac- 
turers are responsible for providing adequate operating instructions and 
for warning consumers about the risks of using their products. Figure 2.2 
shows a warning label used to inform people of how to avoid a safety risk. 

Manufacturers of products used in the United States have a legal duty to 
warn users by providing safety labels on products (and the same information 
in their accompanying instructions) and by explaining in the instructions 
how to use the products safely. According to intellectual-property attorney 
Kenneth Ross (2011), the manufacturer has this duty to warn when all four of 
these characteristics apply: 


1. The product is dangerous. 

2. The danger is or should be known by the manufacturer. 

3. The danger is present when the product is used in the usual and expected 
manner. 


4. The danger is not obvious to or well known by the user. 

The complication for technical communicators is that one set of guidelines 
regarding duty to warn is used in the United States (the American National 
Standards Institute’s ANSI Z535, last revised in 2011) and another set is used 
in the European Union (the International Organization for Standardization’s 
ISO 3864, which is updated periodically). Both sets of guidelines are relatively 
vague, and they contradict each other in important ways. Therefore, before 
publishing labels or instructions for products that can be dangerous, consult 
with an attorney who specializes in liability issues. 
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GUIDELINES 


Abiding by Liability Laws 


Pamela S. Helyar summarizes the communicator's obligations and offers ten guide- 
lines for abiding by liability laws (1 992): 

► Understand the product and its likely users. Learn everything you can about the 
product and its users. 

► Describe the product's functions and limitations. Help people determine 
whether it is the right product to buy. In one case, a manufacturer was found 
liable for not stating that its electric smoke alarm does not work during a power 
outage. 

► Instruct users on all aspects of ownership. Include assembly, installation, use 
and storage, testing, maintenance, first aid and emergencies, and disposal. 

► Use appropriate words and graphics. Use common terms, simple sentences, 
and brief paragraphs. Structure the document logically, and include specific 
directions. Make graphics clear and easy to understand; where necessary, show 
people performing tasks. Make the words and graphics appropriate to the edu- 
cational level, mechanical ability, manual dexterity, and intelligence of intended 
users. For products that will be used by children or nonnative speakers of your 
language, include graphics illustrating important information. 

► Warn users about the risks of using or misusing the product. Warn users 
about the dangers of using the product, such as chemical poisoning. Describe 
the cause, extent, and seriousness of the danger. A car manufacturer was 
found liable for not having warned consumers that parking a car on grass, 
leaves, or other combustible material could cause a fire. For particularly dan- 
gerous products, explain the danger and how to avoid it, and then describe 
how to use the product safely. Use mandatory language, such as must and 
shall, rather than might, could, or should. Use the words warning and caution 
appropriately. 

► Include warnings along with assertions of safety. When product information 
says that a product is safe, readers tend to pay less attention to warnings. There- 
fore, include detailed warnings to balance the safety claims. 

► Make directions and warnings conspicuous. Safety information must be in large 
type and easily visible, appear in an appropriate location, and be durable enough 
to withstand ordinary use of the product. 

► Make sure that the instructions comply with applicable company standards 
and local, state, and federal laws. 

► Perform usability testing on the product (to make sure it is safe and easy to 
use) and on the instructions (to make sure they are accurate and easy to under- 
stand). 

► Make sure users receive the information. If you discover a problem after the 
product has been shipped to retailers, tell users by direct mail or email, if pos- 
sible, or newspaper and online advertising if not. Automobile-recall notices are 
one example of how manufacturers contact their users. 


For a discussion of danger, warning, 
and caution, see Ch. 20, p. 559. 


For a discussion of usability testing, 
seeCh. 13, p.348. 
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The Role of Corporate Culture 
in Ethical and Legal Conduct 

Most employees work within organizations, such as corporations and gov- 
ernment agencies. We know that organizations exert a powerful influence 
on their employees’ actions. According to a study by the Ethics Resource 
Center of more than 4,600 employees in various businesses (2012), organi- 
zations with strong ethical cultures — organizations in which ethical values 
are promoted at all levels and employees see that everyone lives up to the 
organization’s stated values — experience fewer ethical problems than orga- 
nizations with weak ethical cultures. In organizations with strong ethical 
cultures, far fewer employees feel pressure to commit misconduct, far fewer 
employees observe misconduct, far more employees report the misconduct 
that they see, and there is far less retaliation against employees who report 
misconduct. 

Companies can take specific steps to improve their ethical culture: 

• The organization’s leaders can set the right tone by living up to their 

commitment to ethical conduct. 

• Supervisors can set good examples and encourage ethical conduct. 

• Peers can support those employees who act ethically. 

• The organization can use informal communication to reinforce the formal 

policies, such as those presented in a company code of conduct. 

In other words, it is not enough for an organization to issue a statement 
that ethical and legal behavior is important. The organization has to create a 
culture that values and rewards ethical and legal behavior. That culture starts 
at the top and extends to all employees, and it permeates the day-to-day 
operations of the organization. 

One company that has earned praise for its commitment to ethical and 
legal conduct is Texas Instruments (TI). Its culture is communicated on its 
website, which contains a comprehensive set of materials that describes how 
TI employees and suppliers are required to act and why (Texas Instruments, 
2010). On the TI site are a number of resources, including a statement from 
the President and Chief Executive Officer, Rich Templeton, on the company’s 
core values of respect for people and the environment and trust in business 
relationships; the company’s formal code of conduct for all employees; its 
code of ethics for company officers; information about the company’s Ethics 
Office; links to all of its ethics publications; its statement of ethics for its 
suppliers; and detailed information on how to contact the IT Ethics Office 
confidentially. 

Does the Texas Instruments culture improve conduct? Although that ques- 
tion is difficult to answer, the TI site lists some of the major awards the com- 
pany has won for its ethics program, presents data from its own employee 
surveys showing that employees think the company’s ethical culture is good, 
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and describes the company’s outreach to communities and other organiza- 
tions that have established their own ethics programs. 

An important element of a culture of ethical and legal conduct is a formal 
code of conduct. Most large corporations in the United States have one, as do 
almost all professional societies. (U.S. companies that are traded publicly are 
required to state whether they have a code of conduct — and if not, why not.) 
Codes of conduct vary greatly from organization to organization, but most of 
them address such issues as the following: 

• adhering to local laws and regulations, including those intended to protect 
the environment 

• avoiding discrimination 

• maintaining a safe and healthy workplace 

• respecting privacy 

• avoiding conflicts of interest 

• protecting the company’s intellectual property 

• avoiding bribery and kickbacks in working with suppliers and customers 
A code of conduct focuses on behavior, including such topics as adhering 

to the law. Many codes of conduct are only a few paragraphs long; others are 
lengthy and detailed, some consisting of several volumes. 

An effective code has three major characteristics: 

• It protects the public rather than members of the organization or profession. 

For instance, the code should condemn unsafe building practices but not 
advertising, which increases competition and thus lowers prices. 

• It is specific and comprehensive. A code is ineffective if it merely states that 
people must not steal or if it does not address typical ethical offenses such 
as bribery in companies that do business in other countries. 

• It is enforceable. A code is ineffective if it does not stipulate penalties, 
including dismissal from the company or expulsion from the profession. 
Although many codes are too vague to be useful in determining whether a 

person has violated one of their principles, writing and implementing a code 
can be valuable because it forces an organization to clarify its own values 
and fosters an increased awareness of ethical issues. Texas Instruments, like 
many organizations, encourages employees to report ethical problems to a 
committee or a person (sometimes called an ethics officer or an ombudsperson) 
who investigates and reaches an impartial decision. 

If you think there is a serious ethical problem in your organization, find 
out what resources your organization offers to deal with it. If there are no 
resources, work with your supervisor to solve the problem. 

What do you do if the ethical problem persists even after you have 
exhausted all the resources at your organization and, if appropriate, the pro- 
fessional organization in your field? The next step will likely involve whistle- 
blowing — the practice of going public with information about serious unethi- 
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cal conduct within an organization. For example, an engineer is blowing the 
whistle when she tells a regulatory agency or a newspaper that quality- 
control tests on a company product were faked. 

Ethicists such as Velasquez (2011) argue that whistle-blowing is justified if 
you have tried to resolve the problem through internal channels, if you have 
strong evidence that the problem is hurting or will hurt other parties, and 
if the whistle-blowing is reasonably certain to prevent or stop the wrongdo- 
ing. But Velasquez also points out that whistle-blowing is likely to hurt the 
employee, his or her family, and other parties. Whistle-blowers can be penal- 
ized through negative performance appraisals, transfers to undesirable loca- 
tions, or isolation within the company. The Ethics Resource Center reports 
in its 2012 survey that 22 percent of whistle-blowers experienced retaliation 

(2012, p. 12). 


Understanding Ethical and Legal 
Issues Related to Social Media 

There is probably some truth to social-media consultant Peter Shankman’s 
comment “For the majority of us, social media is nothing more than a faster 
way to screw up in front of a larger number of people in a shorter amount of 
time” (Trillos-Decarie, 2012). As social media have become more important 
in the workplace, we are starting to get a better idea of both their rewards 
and their risks. Certainly, social media have created many new and exciting 
ways for people in the workplace to connect with each other and with other 
stakeholders outside the organization. However, the widespread use of social 
media by employees in the workplace and in their private lives also presents 
challenges. 

User-generated content, whether it is posted to Facebook, Twitter, 
Linkedln, YouTdbe, Google Groups, Yelp, Pinterest, or any of the many other 
online services, presents significant new ethical and legal issues. Just as 
employers are trying to produce social-media policies that promote the 
interests of the organization without infringing on employees’ rights of free 
expression, all of us need to understand the basics of ethical and legal prin- 
ciples related to these new media. 

A 2012 report by the law firm Proskauer Rose LLP, “Social Media in the 
Workplace Around the World 2.0,” surveyed some 250 companies from the 
United States and many other countries. Here are some of the survey find- 
ings (Proskauer Rose LLP, 2012, p. 2): 

• More than two-thirds of employers have social-media policies. 

• More than one-third of employers monitor their employees’ use of social- 

media sites. 
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• One-quarter of employers block employee access to social media. 

• Half of the employers reported problems caused by misuse of social media 
by employees. One-third of businesses have had to take disciplinary action 
against an employee for misuse of social media. 

Over the next few years, organizations will revise their policies about how 
employees may use social media in the workplace, just as courts will clarify 
some of the more complicated issues related to social media and the law. 

For these reasons, what we now see as permissible and ethical is likely to 
change. Still, it is possible to identify a list of best practices that can help you 
use social media wisely — and legally — in your career. 


These nine guidelines can help you use social media to your advantage in your 

career. 

► Keep your private social-media accounts separate from your company- 
sponsored accounts. After you leave a company, you don't want to get into a 
dispute over who "owns" an account. Companies can argue, for example, that 
your collection of Twitter followers is in fact a customer list and therefore the 
company's intellectual property. Regardless of whether you post from the 
workplace or at home, post only about business on your company-sponsored 
accounts. 

► Read the terms of service of every service to which you post. Although you 
retain the copyright on original content that you post, most social-media services 
state that they can re-post your content wherever and whenever they want, 
without informing you, getting your permission, or paying you. Many employers 
would consider this policy unacceptable. 

► Avoid revealing unauthorized news about your own company. A company 
that wishes to apply for a patent for one of its products or processes has, ac- 
cording to the law, only one year to do so after the product or process is first 
mentioned or illustrated in a "printed publication.” Because courts have found 
that a photo on Facebook or a blog or even a tweet is equivalent to a printed 
publication (Bettinger, 2010), you could inadvertently start the clock ticking. 
Even worse, some other company could use the information to apply for a 
patent for the product or process that your company is developing. Or suppose 
that on your personal blog, you reveal that your company's profits will dip in 
the next quarter. This information could prompt investors to sell shares of your 
company's stock, thereby hurting everyone who owns shares — including you 
and most of your co-workers. 

► Avoid self-plagiarism. Self-plagiarizing is the act of publishing something you 
have already published. If you write an article for your company newsletter and 
later publish it on a blog, you are violating your company's copyright, because 
your newsletter article was a work made for hire and therefore the company's 
intellectual property. 


4\ 
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► Avoid defaming anyone. Defamation is the legal term for making false state- 
ments of fact about a person that could harm that person. Defamation includes 
libel (making such statements in writing, as in a blog post) and slander (making 
them in speech, as in a video posted online). In addition, you should not re-post 
libelous or slanderous content that someone else has created. 

► Don't live stream or quote from a speech or meeting without permission. Al- 
though you may describe a speech or meeting online, you may not stream video 
or post quotations without permission. 

► Avoid false endorsements. The Federal Trade Commission has clear rules defin- 
ing false advertising. The most common type of false advertising involves posting 
a positive review of a product or company in exchange for some compensation. 
For instance, some unscrupulous software companies give reviewers a copy of 
the software to be reviewed (which is perfectly legal) loaded on an expensive 
computer that the reviewers can keep. Unless the reviewer explicitly notes in the 
review the compensation from the software company, posting the positive re- 
view is considered false advertising. Similarly, you should not endorse your own 
company's products without stating your relationship with the company (U.S. 
Federal Trade Commission, 2009). 

► Avoid impersonating someone else online. If that person is real (whether alive 
or dead), you could be violating his or her right of publicity (the right to control 
his or her name, image, or likeness). If that person is a fictional character, such as 
a character on a TV show or in a movie, you could be infringing on the copyright 
of whoever created that character. 

► Avoid infringing on trademarks by using protected logos or names. Don't 
include copyrighted or trademarked names, slogans, or logos in your posts 
unless you have received permission to do so. Even if the trademark owner 
likes your content, you probably will be asked to stop posting it. If the trade- 
mark owner dislikes your content, you are likely to face a more aggressive 
legal response. 


Finally, a related suggestion: avoid criticizing your employer online. 
Although defamation laws forbid making untrue factual statements about 
your employer, you are in fact permitted to criticize your employer, online or 
offline. The National Labor Relations Board has ruled that doing so is legal 
because it is protected discussion about “working conditions.” My advice: 
if you’re angry, move away from the keyboard. Once you post something, 
you’ve lost control of it. 

However, if you think your employer is acting illegally or unethically, start 
by investigating the company’s own resources for addressing such problems. 
Then, if you are still dissatisfied, consider whistle-blowing, which is dis- 
cussed on p. 31. 
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DOCUMENT ANALYSIS ACTIVITY 


Presenting Guidelines for Using Social Media 


O 


Overview 


In today's world, just about everything we do online can be traced back to us and 
can have an impact (for better or worse) on a company. Paragon wants to remind 
you that the company policies on anti-harassment, ethics, and company loyalty 
extend to all media. There is a certain etiquette you should abide by when you 
participate online. This document is not intended to be restrictive, but to provide 
some guidelines on proper social-networking etiquette. 


What Are Social Media? 

Social media are the tools and content that enable people to connect online, 
share their interests, and engage in conversations. 


Guidelines 


These policies apply to individuals who want to participate in social-media 
conversations on behalf of Paragon. Please be mindful that your behavior at all 
times reflects on Paragon as a whole. Do not write or post anything that might 
reflect negatively on Paragon. 


0 


Always use your best judgment and be honest. 

Be respectful of confidential information (such as clients, financials). 


Always be professional, especially when accepting criticism. 


Participate, don't promote. Bring value. Give to get. 


Write only about what you know. 

When in doubt, ask for help/clarification. 


Seek approval before commenting on any articles that portray Paragon 
negatively. 


This excerpt is from a corporate 
social-media policy statement. 
The questions below ask you to 
think about how to make the 
policy statement clearer and 
more useful (as discussed on 
page 33). 

1. The "Overview" section 
discusses the company's 
social-media policy guide- 
lines in terms of etiquette. 

In what way is"etiquette" 
an appropriate word to 
describe the policy? In what 
way is it inappropriate? 

2 . The "What Are Social 
Media?" section provides 
little useful information. 
What other information 
might it include to make the 
document more useful to 
Paragon employees? 

3 . The bulleted guidelines 
are vague. Revise any two 
of them to include more 
specific information. 
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Communicating Ethically Across Cultures 

Every year, the United States exports more than $2.1 trillion worth of 
goods and services to the rest of the world (U.S. Census Bureau, 2012, 
p. 832). U.S. companies do not necessarily have the same ethical and legal 
obligations when they export as when they sell in the United States. For 
this reason, communicators should understand the basics of two aspects 
of writing for people in other countries: communicating with cultures 
with different ethical beliefs and communicating in countries with differ- 
ent laws. 

COMMUNICATING WITH CULTURES WITH 
DIFFERENT ETHICAL BELIEFS 

Companies face special challenges when they market their products and 
services to people in other countries (and to people in their home countries 
who come from other cultures). Companies need to decide how to deal with 
situations in which the target culture’s ethical beliefs clash with those of 
their own culture. For instance, in many countries, sexual discrimination 
makes it difficult for women to assume responsible positions in the work- 
place. If a U.S. company that sells cell phones, for example, wishes to present 
product information in such a country, should it reinforce this discrimina- 
tion by excluding women from photographs of its products? Ethicist Thomas 
Donaldson argues that doing so is wrong (1991). According to the principle he 
calls the moral minimum, companies are ethically obligated not to reinforce 
patterns of discrimination in product information. 

However, Donaldson argues, companies are not obligated to challenge 
the prevailing prejudice directly. A company is not obligated, for example, 
to include photographs that show women performing roles they do not 
normally perform within a particular culture, nor is it obligated to portray 
women wearing clothing, makeup, or jewelry that is likely to offend local 
standards. But there is nothing to prevent an organization from adopting a 
more activist stance. Organizations that actively oppose discrimination are 
acting admirably. 

COMMUNICATING IN COUNTRIES WITH DIFFERENT LAWS 

When U.S. companies export goods and services to other countries, they 
need to adhere to those countries’ federal and regional laws. For instance, a 
company that wishes to export to Montreal must abide by the laws of Quebec 
Province and of Canada. A company that wishes to export to Germany must 
abide by the laws of Germany and of the European Union, of which it is a 
part. In many cases, the target region will not allow the importation of goods 
and services that do not conform to local laws. The hazardous-product laws 
of the European Union, in particular, are typically more stringent than those 
of the United States. 

Because exporting goods to countries with different laws is such a com- 
plex topic, companies that export devote considerable resources to finding 
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out what they need to do, not only in designing and manufacturing products 
but also in writing the product information. For a good introduction to this 
topic, see Lipus (2006). 


Principles for Ethical Communication 

Although it is impossible to state principles for ethical communication that 
will guide you through all the challenges you will face communicating in the 
workplace, the following ten principles provide a starting point. 

ABIDE BY RELEVANT LAWS 

You must adhere to the laws governing intellectual property. Here are some 
examples: 

• Do not violate copyright. When you want to publish someone else’s 
copyrighted material, such as graphics you find on the Web, get written 
permission from the copyright owner. 

• Honor the laws regarding trademarks. For instance, use the trademark 
symbol (™) and the registered trademark symbol (®) properly. 

• Live up to the express and implied warranties on your company's products. 

• Abide by all laws governing product liability. Helyar’s (1992) guidelines, 
presented on page 29, are a good introduction for products to be sold in 
the United States. Lipus’s (2006) guidelines are useful for products to be 
sold outside the United States. 

ABIDE BY THE APPROPRIATE PROFESSIONAL CODE 
OF CONDUCT 

Your field’s professional organization, such as the American Society of Civil 
Engineers, is likely to have a code that goes beyond legal issues to express 
ethical principles, such as telling the truth, reporting information accurately, 
respecting the privacy of others, and avoiding conflicts of interest. 

ABIDE BY YOUR ORGANIZATION'S POLICY ON SOCIAL MEDIA 

If your employer has a written policy about how employees may use social 
media, study it. If there is no written policy, check with Human Resources or 
your supervisor for advice. If you think that you will be unable to abide by 
the employer’s policy — whether written or not — you should not work there or 
you should abide by it while you try to change it. 

TAKE ADVANTAGE OF YOUR EMPLOYER'S ETHICS RESOURCES 

Your employer is likely to have a code of conduct, as well as other 
resources, such as an Ethics Office, which can help you find information to 
guide you in resolving ethical challenges you encounter. Your employer will 
likely have a mechanism for registering complaints about unethical con- 
duct anonymously. 
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For a more detailed discussion of 
misleading writing, see Ch. 10. For 
a discussion of avoiding misleading 
graphics, seeCh. 12. 


For techniques for writing clearly, 
including avoiding discriminatory 
language, see Ch. 1 0. 



% beans 


FIGURE 2.3 Using 
Design to Emphasize 
Important Information 

This nutritional labeling system 
is called “traffic-light labeling" 
because it uses red and green to 
indicate how healthful a food is. 
Shaun Finch — 

Coyote-Photography.co.uk/Alamy. 


TELL THE TRUTH 

Sometimes, employees are asked to lie about their companies’ products or 
about those of their competitors. Obviously, lying is unethical. Your responsi- 
bility is to resist this pressure, going over your supervisor’s head if necessary. 

DON'T MISLEAD YOUR READERS 

A misleading statement — one that invites or even encourages the reader to 
reach a false conclusion — is ethically no better than lying. Avoid these four 
common kinds of misleading technical communication: 

• False implications. If, as an employee of SuperBright, you write “Use only 
SuperBright batteries in your new flashlight,” you imply that only that brand 
will work. If that is untrue, the statement is misleading. Communicators 
sometimes use cliches such as user-friendly, ergonomic, and state-of-the-art to 
make a product sound better than it is; use specific, accurate information to 
back up your claims about a product. 

• Exaggerations. If you say “Our new Operating System 2500 makes system 
crashes a thing of the past” when the product only makes them less 
likely, you are exaggerating. Provide specific technical information on the 
reduction of crashes. Similarly, do not write “We carried out extensive 
market research” if all you did was make a few phone calls. 

• Legalistic constructions. It is unethical to write “The 3000X was designed 
to operate in extreme temperatures, from -40 degrees to 120 degrees 
Fahrenheit” if the product does not operate reliably in those temperatures. 
Although the statement might technically be accurate — the product was 
designed to operate in those temperatures — it is misleading. 

• Euphemisms. If you refer to someone’s being fired, say released, not granted 
permanent leave or offered an alternatiue career opportunity. 

USE DESIGN TO HIGHLIGHT IMPORTANT 
ETHICAL AND LEGAL INFORMATION 

Courts have found that burying information in footnotes or printing it in very 
small type violates a company’s obligation to inform consumers and warn 
them about hazards in using a product. When you want to communicate safety 
information or other facts that readers need to know, use design features to 
make that information easy to see and understand. Figure 2.3 shows how design 
principles can be used to communicate nutritional information on food labels. 

BE CLEAR 

Clear writing helps your readers understand your message easily. Your 
responsibility is to write as clearly as you can to help your audience under- 
stand what you are saying. For instance, if you are writing a product war- 
ranty, make it as simple and straightforward as possible. Don’t hide behind 
big words and complicated sentences. Use tables of contents, indexes, and 
other accessing devices to help your readers find what they need. 
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AVOID DISCRIMINATORY LANGUAGE 

Don’t use language that discriminates against people because of their sex, 
religion, ethnicity, race, sexual orientation, or physical or mental abilities. 
Employees have been disciplined or fired for sending inappropriate jokes 
through the company email system. 

ACKNOWLEDGE ASSISTANCE FROM OTHERS 

Don’t suggest that you did all the work yourself if you didn’t. Cite your 
sources and your collaborators accurately and graciously. For more about cit- 
ing sources, see Appendix, Part B, page 614. 


WRITER'S CHECKLIST 


I I Did you abide by relevant laws? (p. 37) 

\ Did you abide by the appropriate corporate or 
professional code of conduct? (p. 37) 

U Did you abide by your organization's policy on social 
media? (p. 37) 

□ Did you take advantage of your company's ethics 
resources? (p. 37) 

□ Did you tell the truth? (p. 38) 


Did you avoid using 

I I false implications? (p. 38) 

n exaggerations? (p. 38) 

legalistic constructions? (p. 38) 

□ euphemisms? (p. 38) 

I Did you use design to highlight important ethical and 
legal information? (p. 38) 

Did you write clearly? (p. 38) 

I Did you avoid discriminatory language? (p. 39) 

III Did you acknowledge any assistance you received from 
others? (p. 39) 


EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1. It is late April, and you need a summer job. On your 
town's news website, you see an ad for a potential job. 
The only problem is that the ad specifically mentions that 
the job is "a continuing, full-time position."You know that 
you will be returning to college in the fall. Is it ethical for 
you to apply for the job without mentioning this fact? 
Why or why not? If you believe it is unethical to withhold 
that information, is there any ethical way you can apply? 
Be prepared to share your ideas with the class. 

2. You serve on the Advisory Committee of your college's 
bookstore, which is a private business that leases 
space on campus and donates 1 0 percent of its profits 
to student scholarships. The head of the bookstore 
wishes to stock Simple Study Guides, a popular 
series of plot summaries and character analyses of 


classic literary works. In similar bookstores, the sale 
of Simple Study Guides yields annual profits of over 
$ 1 0,000. Six academic departments have signed a 
statement condemning the idea. Should you support 
the bookstore head or the academic departments? Be 
prepared to discuss your answer with the class. 

3. Using the search term "social media policy examples," find 
a corporate policy statement on employee use of social 
media. In a 500-word memo to your instructor, explain 
whether the policy statement is clear, specific, and 
comprehensive. Does the statement include a persuasive 
explanation of why the policy is necessary? Is the tone of 
the statement positive or negative? How would you feel if 
you were required to abide by this policy? If appropriate, 
include a copy of the policy statement (ora portion of it) 
so that you can refer to it in your memo. 
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4. TEAM EXERCISE Form small groups. Study the 

website of a company or other organization that has a 
prominent role in your community or your academic 
field. Find information about the organization's 
commitment to ethical and legal conduct. Often, 
organizations present this information in sections with 
titles such as "information for investors, ""about the 
company,"or"values and principles of conduct." 

• One group member could identify the section that 
states the organization's values. How effective is this 
section in presenting information that goes beyond 
general statements about the importance of ethical 
behavior? 

• A second group member could identify the section 
that describes the organization's code of conduct. Does 
the organization seem to take principles of ethical and 


legal behavior seriously? Can you get a clear idea from 
the description whether the organization has a specific, 
well-defined set of policies, procedures, and resources 
available for employees who wish to discuss ethical and 
legal issues? 

• A third group member could identify any 
information related to the organization's 
commitment to the environment. What does the 
organization do, in its normal operations, to limit 
its carbon footprint and otherwise encourage 
responsible use of natural resources and limit 
damage to the environment? 

• As a team, write a memo to your instructor 
presenting your findings. Attach the organization's 
code to your memo. 


For more practice with the concepts covered in Chapters 1 -4, 
la complete the LearningCurve activity "Understanding the 
Technical Communication Environment" under "Additional Resources" 

in Ch. 2: macmillanhighered.com/launchpad/techcomm11e. 


J CASE 2: The Ethics of Requiring Students To Subsidize a Plagiarism-Detection Service 



The provost of your university has sent a letter to you and other members of the Student 
Council proposing that the university subscribe to a plagiarism-detection service, the cost 
of which would be subsidized by students' tuition. You and other council members have 
some serious concerns about the proposal and decide to write to the provost analyzing the 
ethical implications of requiring students to subsidize such a program. To read the provost's 
letter and begin drafting your response, go to "Cases" under "Additional Resources" in Ch. 2: 
macmillanhighered.com/launchpad/techcomm1 1 e. 
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THIS CHAPTER PRESENTS a writing process that focuses on the techniques 
and tools most useful for technical writers. Should you use the process described 
here? If you don't already have a process that works for you, yes. But your goal 
should be to devise a process that enables you to write effective documents (that 
is, documents that accomplish your purpose) efficiently (without taking more time 
than necessary). At the end of this chapter, you will find a Writer's Checklist. After 
you try implementing some of the techniques described in this chapter, you can 
start to revise the Writer's Checklist to reflect the techniques that you find most 
effective. 

The writing process consists of five steps: planning, drafting, revising, editing, 
and proofreading. The frustrating part of writing, however, is that these five 
steps are not linear. That is, you don't plan the document, then check off a box 
and go on to drafting. At any step, you might double back to do more planning, 
drafting, or revising. Even when you think you're almost done — when you're 
proofreading — you still might think of something that would improve the 
document. That means you'll need to go back and rethink all five steps. 

As you backtrack, you will have one eye on the clock, because the deadline 
is sneaking up on you. That's the way it is for all writers. A technical writer stops 
working on a user manual because she has to get it off to the print shop. An 
engineer stops working on a set of slides for a conference presentation because 
it's time to head for the airport. So, when you read about how to write, remember 
that you are reading about a messy process that goes backward as often as it 
goes forward and that, most likely, ends only when you run out of time. 

Remember, too, that many of the documents you produce will never truly be 
"finished." Many types of documents that live online are called living documents 
because they are meant to be revised as new information becomes available or 
policies change. Benefits manuals, for example, keep changing. 

Planning 

Planning, which can take more than a third of the total time spent on a 
writing project, is critically important for every document, from an email 
message to a book-length manual. Start by thinking about your audience, 
because you need to understand whom you are writing to before you can 
figure out what you need to say about your subject. 
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ANALYZING YOUR AUDIENCE 

If you are lucky, you can talk with your audience before and during your work 
on the document. These conversations can help you learn what your readers 
already know, what they want to know, and how they would like the informa- 
tion presented. You can test out drafts, making changes as you go. 

Even if you cannot consult your audience while writing the document, you 
still need to learn everything you can about your readers so that you can deter- 
mine the best scope, organization, and style for your document. Then, for each 
of your most important readers, try to answer the following three questions: 

• Who is your reader? Consider such factors as education, job experience 
and responsibilities, skill in reading English, cultural characteristics, and 
personal preferences. 

• What are your reader's attitudes and expectations? Consider the reader’s 
attitudes toward the topic and your message, as well as the reader’s 
expectations about the kind of document you will be presenting. 

• Why and how will the reader use your document? Think about what readers 
will do with the document. This includes the physical environment in 
which they will use it, the techniques they will use in reading it, and the 
tasks they will carry out after they finish reading it. 

ANALYZING YOUR PURPOSE 

You cannot start to write until you can state the purpose (or purposes) of the 
document. Ask yourself these two questions: 

• After your readers have read your document, what do you want them to 
know or do? 

• What beliefs or attitudes do you want them to hold? 

A statement of purpose might be as simple as this: “The purpose of this 
report is to recommend whether the company should adopt a health- 
promotion program.” Although the statement of purpose might not appear 
in this form in the final document, you want to state it clearly now to help 
you stay on track as you carry out the remaining steps. 

CHOOSING YOUR WRITING TOOLS 

Writers have more tools available to them than ever before. You probably do 
most of your writing with commercial software such as Microsoft Office or open- 
source software such as Open Office, and you will likely continue to do much of 
your writing with these tools. Because of the rapid increase in the number and 
type of composition tools, however, knowing your options and choosing the one 
that best meets your needs can help you create a stronger document. 

If you travel often or if many people in different locations will collaborate 
on a given document, you may find it useful to work with a cloud-based tool 
such as Google Drive. Specialized tools built for professional writers can be 
particularly useful for long, complicated projects that require heavy research; 


For more about analyzing your 
audience, see Ch. 5, p. 87. 


For more about analyzing your 
purpose, see Ch. 5, p. 84. 


To watch a tutorial on 
cross-platform word 
processing, go to Ch. 3 > Additional 
Resources > Tutorials: 

macmillanhighered.com 
/launchpad/techcomml 1e. 
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Scrivener, for example, lets you gather your research data in a single location 
and easily reorganize your document at the section or chapter level. Compo- 
sition programs optimized for tablets, such as WritePad, convert handwriting 
into text, translate text into a number of languages, and feature cloud-based 
storage. Before you begin a big project, consider which type of writing tool 
will best meet your project’s needs. 

GENERATING IDEAS ABOUT YOUR SUBJECT 

Generating ideas is a way to start mapping out the information you will need 
to include in the document, deciding where to put it, and identifying addi- 
tional information that may be required. 

First, find out what you already know about the topic by using any of the 
techniques shown in Table 3.1. 


TABLE 3.1 Techniques for Generating Ideas About YourTopic 


TECHNIQUE 

EXPLANATION 

EXAMPLE 

Asking the six 
journalistic questions 

Asking who, what, when, where, why, and 
how can help you figure out how much 
more research you need to do. Note that 
you can generate several questions from 
each of these six words. 

• Who would be able to participate? 

• Who would administer it? 

• What would the program consist of? 

Brainstorming 

Spending 1 5 minutes listing short 
phrases and questions about your 
subject helps you think of related ideas. 
Later, when you construct an outline, 
you will rearrange your list, add new 
ideas, and toss out some old ones. 

• Why we need a program 

• Lower insurance rates 

• On-site or at a club? 

• Who pays for it? 

• What is our liability? 

• Increase our productivity 

Freewriting 

Writing without plans or restrictions, 
without stopping, can help you 
determine what you do and do not 
understand. And one phrase or sentence 
might spark an important idea. 

A big trend today in business is sponsored health- 
promotion programs. Why should we do it? 

Many reasons, including boosting productivity 
and lowering our insurance premiums. But it's 
complicated. One problem is that we can actually 
increase our risk if a person gets hurt. Another is the 
need to decide whether to have the program — what 
exactly is the program? . . . 

Talking with someone 

Discussing your topic can help you find 
out what you already know about it 
and generate new ideas. Simply have 
someone ask you questions as you 
speak. Soon you will find yourself in a 
conversation that will help you make 
new connections from one idea to 
another. 

You: One reason we might want to do this is to 
boost productivity. 

Bob: What exactly are the statistics on increased 
productivity? And who has done the studies? Are 
they reputable? 

You: Good point. I'm going to have to show that 
putting money into a program is going to pay off. 
1 need to see whether there are unbiased recent 
sources that present hard data. 
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TABLE 3.1 Techniques for Generating Ideas About YourTopic (continued) 


TECHNIQUE EXPLANATION EXAMPLE 


Clustering 


One way to expand on your topic is to 
write your main idea or main question 
in the middle of the page and then 
write second-level and third-level ideas 
around it. 



Branching 


Another way to help you expand on 
your topic is to write your main idea or 
question at the top of the page and then 
write second-level and third-level ideas 
below it. 


Institute a health-promotion program? 


Who? 


How? 


? advice from research it 
insurance ourselves? 
co.? 


Where? 


on- 

site? 


at 

health 

dub? 


Why? 


increase reduce reduce 

productivity illness, premiums 

injury 


RESEARCHING ADDITIONAL INFORMATION 

Once you have a good idea of what you already know about your topic, For more about conducting research, 

you must obtain the rest of the information you will need. You can find seeCh. 6. 

and evaluate what other people have already written by reading reference 
books, scholarly books, articles, websites, and reputable blogs and discus- 
sion boards. In addition, you might compile new information by interview- 
ing experts, distributing surveys and questionnaires, making observations, 
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sending inquiries, and conducting experiments. Don’t forget to ask questions 
and gather opinions from your own network of associates, both inside and 
outside your organization. 


For more about organizing your 
information, see Ch. 7. 

}P^ To watch a tutorial on creating 
. outlines, go to Ch. 3 > 
Additional Resources > Tutorials: 

macmillanhighered.com 
/launchpad/techcomml 1e. 


ORGANIZING AND OUTLINING YOUR DOCUMENT 

Although each document has its own requirements, you can use existing 
organizational patterns or adapt them to your own situation. For instance, the 
compare-and-contrast pattern might be an effective way to organize a discus- 
sion of different health-promotion programs. The cause-and-effect pattern 
might work well for a discussion of the effects of implementing such a program. 

At this point, your organization is only tentative. When you start to draft, 
you might find that the pattern you chose isn’t working well or that you need 
additional information that doesn’t fit into the pattern. 

Once you have a tentative plan, write an outline to help you stay on track 
as you draft. To keep your purpose clearly in mind as you work, you may 
want to write it at the top of your page before you begin your outline. 


>TECH TIP 


HowTo Use the Outline View 

When organizing your document, you can use the outline 
view to examine and revise the structure of your document. 
To use this view, you must format your document with Word's 
built-in heading styles or outline levels. 


!■: a J® 

;Ta= 1 

m 

Print Full Screen Web 
Layout Reading Layout 

Outline 

Draft 

Document Views 4 



To view the structure of your document, select the View tab 
on the Ribbon and then select Outline. 


A plus sign indicates that a heading has subheadings or text 
associated with it. A minus sign indicates that it does not. 

Headings are indented to show subordinate levels. 



O Planning 

O Analyzing Your Audience 
O Analyzing Your Purpose 
O Generating Ideas about Your Subject 
O Researching Additional Information 
O Organizing and Outlining Your Document 
O Selecting an Application, a Design, and a Delivery Method 
O Devising a Schedule and a Budget 
O Drafting 

O Using Templates 
O Using Styles 
O Revising 

O Studying the Draft by Yourself 
O Seeking Help from Others 



Use the Outlining tab to promote or demote headings or 
body text; to move, expand, or collapse sections; and to show 
levels. 


KEYWORDS: outline view, create a document outline, 
outline levels 
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SELECTING AN APPLICATION, A DESIGN, AND A DELIVERY METHOD 

Once you have a sense of what you want to say, you need to select an appli- 
cation (the type of document), a design, and a delivery method. You have a 
number of decisions to make: 

• Is the application already chosen for me? If you are writing a proposal 
to submit to the U.S. Department of the Interior, for example, you must 
follow the department’s specifications for what the proposal is to look like 
and how it is to be delivered. For most kinds of communication, however, 
you will likely have to select the appropriate application, such as a set of 
instructions or a manual. Sometimes, you will deliver an oral presentation 
or participate in a phone conference or a videoconference. 

• What will my readers expect? If your readers expect a written set of 
instructions, you should present a set of instructions unless some other 
application, such as a report or a manual, is more appropriate. If they 
expect to see the instructions presented in a simple black-and-white 
booklet — and there is no good reason to design something more elaborate 
than that — your choice is obvious. For instance, instructions for installing 
and operating a ceiling fan in a house are generally presented in a small, 
inexpensive booklet with the pages stapled together or on a large, folded 
sheet of paper. However, for an expensive home-theater system, readers 
might expect a glossy, full-color manual. 

• What delivery method will work best? Related to the question of reader 
expectations is the question of how you will deliver the document to your 
readers. For instance, you would likely mail an annual report to your readers 
and upload it to your company website. You might present industry forecasts 
on a personal blog or on one sponsored by your employer. You might deliver 
a user manual for a new type of photo-editing program online rather than in 
print because the program — and therefore the manual — will change. 

It is important to think about these questions during the planning process, 
because your answers will largely determine the scope, organization, style, 
and design of the information you will prepare. As early as the planning step, 
you need to imagine your readers using your information. 


For more about progress reports, see 
Ch. 1 7, p. 452. For more about project 
management, see Ch. 4, p. 60. 


DEVISING A SCHEDULE AND A BUDGET 

During the planning stage, you also must decide when you will need to provide 
the information and how much you can spend on the project. For instance, for 
the project on health-promotion programs, your readers might need a report to 
help them decide what to do before the new fiscal year begins in two months. 
In addition, your readers might want a progress report submitted halfway 
through the project. Making a schedule is often a collaborative process: you 
meet with your main readers, who tell you when they need the information, 
and you estimate how long the different tasks will take. 

You also need to create a budget. In addition to the time you will need 
to do the project, you need to think about expenses you might incur. For 
example, you might need to travel to visit companies with different kinds of 
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For more about usability testing, see 
Ch. 13, p. 348. 


For more about design, see Ch. 11. 


health-promotion programs. You might need to conduct specialized data- 
base searches, create and distribute questionnaires to employees, or conduct 
interviews at remote locations. Some projects call for usability testing — evalu- 
ating the experiences of prospective users as they try out a system or a docu- 
ment. The cost of this testing needs to be included in your budget. 


Drafting 

When you have at least a preliminary outline, it is time to start drafting. Some 
writers like to draft within the outline created on their word-processing pro- 
gram. Others prefer to place a paper copy of their outline on the desk next to 
their keyboard and begin drafting a new document that follows that outline. 

USING TEMPLATES 

For your draft, you might consider using an existing template or modify- 
ing one to meet your needs. Templates are preformatted designs for differ- 
ent types of documents, such as letters, memos, newsletters, and reports. 
Templates incorporate the design specifications for the document, including 
typeface, type size, margins, and spacing. Once you have selected a template, 
you just type in the information. 

Using templates, however, can lead to three problems: 

• They do not always reflect the best design principles. For instance, most 
letter and memo templates default to 10-point type, even though 12-point 
type is easier to read. 

• They bore readers. Readers get tired of seeing the same designs. 

• They cannot help you answer the important questions about your 
document. Although templates can help you format information, they 
cannot help you figure out how to organize and write a document. 
Sometimes, templates can even send you the wrong message. For 
example, resume templates in word processors present a set of headings 
that might work better for some job applicants than for others. 

In addition, the more you rely on existing templates, the less likely you are to 
learn how to use the software to make your documents look professional. 


4 \ 


GUIDELINES 


Drafting Effectively 


Try the following techniques when you begin to draft or when you get stuck in the 
middle of drafting. 


► Get comfortable. Choose a good chair, set at the right height for the keyboard, 
and adjust the light so that it doesn't reflect off the screen. 

► Start with the easiest topics. Instead of starting at the beginning of the docu- 
ment, begin with the section you most want to write. 

[continued] 
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► Draft quickly. Try to make your fingers keep up with your brain. Turn the phrases 
from your outline into paragraphs. You'll revise later. 

► Don't stop to get more information or to revise. Set a timer, and draft for an 
hour or two without stopping. When you come to an item that requires more 
research, skip to the next item. Don't worry about sentence structure or spelling. 

► Try invisible writing. Darken the screen or turn off the monitor so that you can 
look only at your hard-copy outline or the keyboard. That way, you won't be 
tempted to stop typing to revise what you have just written. 

► Stop in the middle of a section. When you stop, do so in the middle of a paragraph 
or even in the middle of a sentence. You will find it easy to conclude the idea you 
were working on when you begin writing again. This technique will help you avoid 
writer's block, the mental paralysis that can set in when you stare at a blank screen. 


TECH TIP 


HowTo Modify Templates 

You can modify an existing document 
template to address your specific writing 
situation. You can then save this modified 
document as a template and use it again 
in similar writing situations. 

1 . To locate an existing template, 

select File and then select New. This 
/will open the Available Templates 
window. Within this window, you can 
study templates already installed on 
your computer as well as ones avail- 
able for download. 



Mjmncr Mwy«UM Mm, fapafl 


fee* 



2. You can start with a Blank Document or with one of the 
many available templates. First, choose a template, and 
then select Create. If you click on a folder of templates, 
such as Sample templates, you can select a template 
and then save it as a document or a template. Select the 
format you want (Document orTemplate), then select 
Create. If you want to save the changes you make for 
future use, be sure to select Template. 


3. After making changes to the design 
of the template, select File and 
then select Save. Your modified 
template will be stored in a file 
you can access later through the 
My Templates tab in the Available 
Templates window. 


Home 



KEYWORDS: templates, about templates, modify a template, 
installed templates, download templates 
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DOCUMENT ANALYSIS ACTIVITY 


Identifying the Strengths and Weaknesses of a Commercial Template 


The template from Microsoft 
Word shown here presents one 
approach to writing a resume. 

Your 

OBJECTIVE 

The questions below ask you to 

Getting the perfect job might be challenging, but a great-looking resume doesn't 
have to be! We've provided a few quick tips to help you get started. To replace any 


think about the assumptions 
underlying this template. 

Name 

tip text with your own, just click it and start typing. 

1. How well does the explana- 

> [Job Title] 

Need another experience or education entry? You got it. Just click in the sample 
entries below and then click the plus sign that appears. Looking for a matching 

tion of how to use the 

> [Job Title] 

cover letter? All you had to do was ask! On the Insert tab, click Cover Page. 

template (located under 
"Objective") help you 


EXPERIENCE 
[Dates From - To] 

understand how to write an 


[Company] 

effective resume? 


[Position Held] 

2 . How well does the template 




> Click here to enter text 

explain how to reformat 
the elements, such as your 


> Click here to enter text 

name? 


EDUCATION 



[Dates From - To] 

3 . Does the template clearly 


[School Name, Location] 

describe what you should do 


[Degree] 

if you wish, for instance, to 




> Click here to enter text 

include a list of references, 

rather than use the phrase 


REFERENCES 

"References are available 


References are available upon request. 

upon request"? 

[Address 1] 
[Address 2] 

[City, ST ZIP Code] 



[Telephone] 

[Email] 

[Website] 


Source: Microsoft, 201 3: http://office.microsoft.com/en-us/templates/results.aspx?qu=resumes&av=zwd&queryid=af655fbb 


-f275-4e67-8f96-9645588b1 bc3#ai:TC1 02835065. Used with permission from Microsoft. 
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USING STYLES 

Styles are like small templates that apply to the design of smaller elements, 
such as headings. Like templates, styles save you time. For example, as you 
draft your document, you don’t need to add all the formatting each time you 
want to designate an item as a first-level heading. You simply highlight the 
text you want to be a first-level heading and use a pull-down menu or ribbon 
at the top of your screen to select that style. The text automatically incorpo- 
rates all the specifications of that style. 

If you decide to modify a style — by italicizing a heading, for instance — 
you need to change it only once; the software automatically changes every 
instance of that style in the document. In collaborative documents, styles 
make it easier for collaborators to achieve a consistent look. 


fl^ To watch a tutorial on creating 
styles and templates in Word, 
go to Ch. 3 > Additional Resources 
> Tutorials: macmillanhighered 
.com/launchpad/techcomm 1 1 e. 


TECH TIP 


HowTo Use the Styles Group 

As you draft your document, you can use the Styles group 
to apply styles to elements such as headings, lists, and body 


2. Another way to apply a style is to 
box launcher and then select the 


select the Styles dialog 
style you wish to use. 
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For more about revising your 
document, seeCh. 13, p.342. 


Revising 

Revising is the process of looking again at your draft to see whether it works. 
After you revise, you will carry out two more steps — editing and proofread- 
ing — but at this point you want to focus on three large topics: 

• Audience. Has your understanding of your audience changed? Will you 
be addressing people you hadn’t considered before? If so, how will that 
change what you should say and how you should say it? 

• Purpose. Has your understanding of your purpose changed? If so, what 
changes should you make to the document? 

• Subject. Has your understanding of the subject changed? Should you 
change the scope — that is, should you address more or fewer topics? 
Should you change the organization of the document? Should you present 
more evidence or different types of evidence? 

On the basis of a new look at your audience, purpose, and subject, you might 
decide that you need to make minor changes, such as adding one or two minor 
topics. Or you might decide that you need to completely rethink the document. 

There are two major ways to revise: by yourself and with the assistance of 
others. If possible, use both ways. 

STUDYING THE DRAFT BY YOURSELF 

The first step in revising is to read and reread your document, looking for 
different things each time. For instance, you might read it once just to see 
whether the information you have presented is appropriate for the various 
audiences you have identified. You might read it another time to see whether 
each of your claims is supported by appropriate and sufficient evidence. 

Start with the largest, most important problems first; then work on the 
smaller, less important ones. That way, you don’t waste time on awkward 
paragraphs you might eventually decide to delete. Begin by reviewing the 
document as a whole (for organization, development, and content), saving the 
sentence-level concerns (such as grammar, punctuation, and spelling) for later. 

One effective way to review your whole document for coherence is to 
study the outline view of the document. Figure 3.1 shows how the outline 
view helps you see how the document is organized. 

After you have studied your draft to see if there are problems with its 
organization, study it to answer six additional questions: 

• Have I left out anything in turning my outline into a draft? 

• Have I included all the elements my readers expect to see? 

• Is the document persuasive? 

• Do I come across as reliable, honest, and helpful? 

• Have I presented all the elements consistently? 

• Is the emphasis appropriate throughout the document? 
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The writer has set the outline 
view to show the first two levels 
of his report. 

Using the outline view, it is 
easy to identify organization 
problems: 

• The results section should 
precede the conclusions and 
recommendations section. 

• In the results section, the sec- 
ond item — survey — seems 
to be different from the other 
two items, both of which 
seem to relate to the topic 
of the vehicles, not to the 
methods the writer used. 

• Appendix A and Appendix B 
should both be second-level 
headings. 

FIGURE 3.1 Studying the Organization of a Document Using the Outline View 


Executive Summary 
Introduction 
Methods 
Conclusions ar 
Results 

© Analysis of Maintem 
© Survey < 

© Truck Comparison and Test Drives 

Work Cited 
Appendixes 

Appendix A — Survey Results 



© Appendix B — IntelliChoice Side by Side Comparison 


SEEKING HELP FROM OTHERS 

For technical documents, it is best to turn to two kinds of people for help. 
Subject-matter experts (SMEs) can help you determine whether your facts 
and explanations are accurate and appropriate. If, for instance, you are 
writing about fuel-cell automobiles, you could ask an automotive expert to 
review your document. Important documents are routinely reviewed by tech- 
nical experts before being released to the public. 

The second category of reviewers includes both actual users of your exist- 
ing document and prospective users of the next version of the document. 
These people can help you see problems you or other knowledgeable read- 
ers don’t notice. For instance, a prospective user of a document on fuel-cell 
technologies might point out that she doesn’t understand what a fuel cell is 
because you haven’t defined the term. 

How do you learn from SMEs and from users and prospective users? Here 
are a few techniques: 

• surveying, interviewing, or observing readers as they use the existing 
document 

• interviewing SMEs about a draft of the document 

• conducting focus groups to learn users’ or prospective users’ opinions 
about an existing or proposed document 

• uploading the document to an online writing space, such as Microsoft 
SharePoint or Google Drive, and authorizing people to revise it 


For more about having another 
person review your draft, see Ch. 4, 
p. 70. 


For more about these techniques, as 
well as usability testing, see Ch. 13, 
p. 347. 



3 


54 


For more about editing for coherence 
and correctness, see Chs. 9 and 10. 
For more about correctness, see 
Appendix, Part C. 


For a discussion of using wikis to 
create collaborative documents, see 
Ch. 4. 


WRITING TECHNICAL DOCUMENTS 

It is important to revise all drafts, but it is especially important to revise 
drafts of documents that will be read and used by people from other cultures. 
If your readers come from another culture, try to have your draft reviewed by 
someone from that culture. That reviewer can help you see whether you have 
made correct assumptions about how readers will react to your ideas and 
whether you have chosen appropriate kinds of evidence and design elements. 
As discussed in Chapters 11 and 12, people from other cultures might be sur- 
prised by some design elements used in reports, such as marginal comments. 


ETHICS NOTE 


ACKNOWLEDGING REVIEWERS RESPONSIBLY 

When you write on the job, take advantage of the expertise of others. It is completely ethical 
to ask subject-matter experts and people who are similar to the intended audience of your 
document to critique a draft of it. If your reviewer offers detailed comments and suggestions 
on the draft or sends you a multipage review — and you use some or many of the ideas — you 
are ethically bound to acknowledge that person's contributions. This acknowledgment can 
take the form of a one- or two-sentence statement of appreciation in the introduction of the 
document or in a transmittal letter. Or you could write a letter or memo of appreciation to the 
reviewer; he or she can then file it and use it for a future performance evaluation. 


Editing 

Having revised your draft and made changes to its content and organiza- 
tion, it’s time for you to edit. Editing is the process of checking the draft to 
improve its grammar, punctuation, style, usage, diction (word choice), and 
mechanics (such as use of numbers and abbreviations). You will do most of 
the editing by yourself, but you might also ask others for assistance, espe- 
cially writers and editors in your organization. One technology that enables 
people at different locations to work together is a wiki, a website that lets 
authorized readers edit a document (also referred to as a wiki) and archives 
all the previous versions of the document. 

The resources devoted to editing will vary depending on the importance of 
the document. An annual report, which is perhaps the single most important 
document that people will read about your organization, will be edited rigor- 
ously because the company wants it to look perfect. A biweekly employee 
newsletter also will be edited, but not as rigorously as an annual report. What 
about the routine emails you write every day? Edit them, too. It’s rude not to. 


Proofreading 

Proofreading is the process of checking to make sure you have typed what 
you meant to type. The following sentence contains three errors that you 
should catch in proofreading: 


There are for major reasons we should implementing health-promotion program. 
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Here they are: 

1. “For” is the wrong word. It should be “four.” 

2. “Implementing” is the wrong verb form. It should be “implement.” This 
mistake is probably left over from an earlier version of the sentence. 

3. The article “a” is missing before the phrase “health-promotion program.” 
This is probably just a result of carelessness. 

By the way, a spell-checker and grammar-checker didn’t flag any of these errors. 

Although some writers can proofread effectively on the screen, others 
prefer to print a copy of the text. These writers say that because the text 
looks different on the page than it does on the screen, they are more likely 
to approach it with fresh eyes, as their eventual readers will, and therefore 
more likely to see errors. 

Regardless of whether you proofread on screen or on paper, the process 
is no fun. You’re exhausted, you’re thoroughly sick of the document, and 
proofreading is not the most exciting thing you have ever done. But it is vital 
to producing a clear, well-written document that reflects your high standards 
and underscores your credibility as a professional. Don’t insult yourself and 
your readers by skipping this step. Reread your draft carefully and slowly, 
perhaps out loud, and get a friend to help. You’ll be surprised at how many 
errors you’ll find. 


WRITER'S CHECKLIST 


In planning the document, did you 
EH analyze your audience? (p. 43) 

. analyze your purpose? (p. 43) 

EH generate ideas about your subject? (p. 44) 

EH research additional information? (p. 45) 

□ organize and outline your document? (p. 46) 

_J select an application, a design, and a delivery method? 
(p. 47) 

EH devise a schedule and a budget? (p. 47) 


In drafting the document, did you 

□ use templates, if appropriate? (p. 48) 

□ use styles? (p. 51) 

In revising the draft, did you 
EH study the draft by yourself? (p. 52) 

I i seek help from others? (p. 53) 

EH Did you edit the document carefully? (p. 54) 

EH Did you proofread the document carefully? (p. 54) 
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EXERCISES 


For more about memos, see Ch. 14, p. 372. 

1 . Read your word processor's online help about using 
the outline view. Make a file with five headings, each 
of which has a sentence of body text below it. Practice 
using the outline feature to do the following tasks: 

a. change a first-level heading to a second-level heading 

b. move the first heading in your outline to the end of 
the document 

c. hide the body text that goes with one of the 
headings 

2 . Your word processor probably contains a number of 
templates for such applications as letters, memos, faxes, 
and resumes. Evaluate one of these templates. Is it clear 
and professional looking? Does it present a design that 
will be effective for all users or only for some? What 
changes would you make to the template to improve 
it? Write a memo to your instructor presenting your 
findings, and attach a copy of the template. 


3 . Proofread the following paragraph. For information 
on writing effective sentences, see Chapter 1 0 and 
Appendix, Part C. 

People who have a federal student loan can apply for 
program from the Department of Education that is 
intended to give relief to former students with moderate 
incomes by sketching the payments out over a longer 
period. The program calculates monthly payments on 
the basis of income. In addition, the program forgave 
balances after 25 years (1 0 years if the the person 
chooses employment in public service). The monthly- 
payment calculation, called income-based repayment 
(IBR), determined by the size of the loan and the persons 
income. For some 90 percent of the more than one 
million people who have already enrolled, the IRB works 
out to less then 10 percent if their income. The program 
also caps the payments at 1 5 percent of a persons 
income over $1 6,000 a year (and eliminates payments for 
people who earn than $16,000). 


For more practice with the concepts covered in Chapters 1 -4, 
complete the LearningCurve activity "Understanding the 
Technical Communication Environment" under "Additional Resources" 

in Ch. 3: macmillanhighered.com/launchpad/techcomm11e. 


CASE 3: Understanding Why Revision Software Cannot Revise and Edit Your Document 



You are an engineer who has been asked to write a project report regarding a defect in 
a wireless heart-rate monitor for bicyclists. Your supervisor has some concerns about 
the quality of the writing in the draft of the report you submitted and has asked you to 
rework the introduction. To get started revising the report, go to "Cases" under "Additional 
Resources" in Ch. 3: macmillanhighered.com/launchpad/techcomm11e. 
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THE EXPLOSIVE GROWTH of social media over the last decade has greatly 
expanded the scope of workplace collaboration, reducing former barriers of 
time and space. Today, people routinely collaborate not only with members of 
their project teams but also with others within and outside their organization, as 
shown in Figure 4.1 . 

But how exactly does this sort of collaboration work? In every possible way. 

For example, you and other members of your project team might use social 



FIGURE 4.1 Collaboration Beyond the Project Team 

Using social media such as messaging technologies, videoconferencing, shared document 
workspaces, and wikis, you can tap into the world's knowledge for ideas and information. 


Advantages and Disadvantages of Collaboration 
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media primarily to gather information that you will use in your research. You bring 
this information back to your team, and then you work exclusively with your 
team in drafting, revising, and proofreading your document. In a more complex 
collaboration pattern, you and other members of your team might use social 
media to gather information from sources around the globe and then reach out 
to others in your organization to see what they think of your new ideas. Later in 
the process, you create the outline of your document, in the form of a wiki, and 
authorize everyone in your own organization to draft sections, pose questions and 
comments, and even edit what others have written. In short, you can collaborate 
with any number of people at one or at several stages of the writing process. 

Every document is unique and will therefore call for a unique kind of 
collaboration. Your challenge is to think creatively about how you can work 
effectively with others to make your document as good as it can be. Being aware 
of the strengths and limitations of collaborative tools can prompt you to find 
people in your building and around the world who can help you think about your 
subject and write about it compellingly and persuasively. 


Advantages and Disadvantages of Collaboration 

As a student, you probably have already worked collaboratively on course 
projects. As a professional, you will work collaboratively on many more proj- 
ects. In the workplace, the stakes might be higher. Effective collaboration can 
make you look like a star, but ineffective collaboration can ruin an important 
project — and hurt your reputation. The best way to start thinking about col- 
laboration is to understand its main advantages and disadvantages. 

ADVANTAGES OF COLLABORATION 

According to a survey conducted by Cisco Systems (2010), more than 75 per- 
cent of those surveyed said that collaboration is critical to their success on 
the job. Some 90 percent said that collaboration makes them more produc- 
tive. Writers who collaborate can create a better document and improve the 
way an organization functions: 

• Collaboration draws on a wider knowledge base. Therefore, a collaborative 
document can be more comprehensive and more accurate than a single- 
author document. 

• Collaboration draws on a wider skills base. No one person can be an expert 
manager, writer, editor, graphic artist, and production person. 

• Collaboration provides a better idea of how the audience will read the 
document. Because each collaborator acts as an audience, working with 
collaborators produces more questions and suggestions than one person 
could while writing alone. 

• Collaboration improves communication among employees. Because you 
and your collaborators share a goal, you learn about each other’s jobs, 
responsibilities, and frustrations. 


For more about the writing process, 
see Ch. 3. 


: To complete a series of 
I interactive team writing 
modules, go to "Additional 
Resources" in Ch. 4: 

macmillanhighered.com 
/launchpad/techcomml 1e. 
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• Collaboration helps acclimate new employees to an organization. New 

employees learn how things work — which people to see, which forms 
to fill out, and so forth — as well as what the organization values, such 
as ethical conduct and the willingness to work hard and sacrifice for an 
important initiative. 

• Collaboration motivates employees to help an organization grow. New 

employees bring new skills, knowledge, and attitudes that can help the 
organization develop. More experienced employees mentor the new 
employees as they learn. Everyone teaches and learns from everyone else, 
and the organization benefits. 

DISADVANTAGES OF COLLABORATION 

Collaboration can also have important disadvantages: 

• Collaboration takes more time than individual writing. It takes longer because 
of the time needed for the collaborators to communicate. In addition, 
meetings — whether they are live or remote — can be difficult to schedule. 

• Collaboration can lead to groupthink. When collaborators value getting along 
more than thinking critically about the project, they are prone to groupthink. 
Groupthink, which promotes conformity, can result in an inferior document, 
because no one wants to cause a scene by asking tough questions. 

• Collaboration can yield a disjointed document. Sections can contradict 
or repeat each other or be written in different styles. To prevent these 
problems, writers need to plan and edit the document carefully. 

• Collaboration can lead to inequitable workloads. Despite the project leader’s 
best efforts, some people will end up doing more work than others. 

• Collaboration can reduce a person's motivation to work hard on the 
document. A collaborator who feels alienated from the team can lose 
motivation to make the extra effort. 

• Collaboration can lead to interpersonal conflict. People can disagree about 
the best way to create the document or about the document itself. Such 
disagreements can hurt working relationships during the project and 
long after. 


Managing Projects 

At some point in your career, you will likely collaborate on a project that is 
just too big, too technical, too complex, and too difficult for your team to 
complete successfully without some advance planning and careful oversight. 
Often, collaborative projects last several weeks or months, and the efforts of 
several people are required at scheduled times for the project to proceed. For 
this reason, collaborators need to spend time managing the project to ensure 
that it not only meets the needs of the audience but also is completed on 
time and, if relevant, within budget. 


Conducting Meetings 
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GUIDELINES 


Managing Your Project 


These seven suggestions can help you keep your project on track. 


► Break down a large project into several smaller tasks. Working backward from 
what you must deliver to your client or manager, partition your project into its 
component parts, making a list of what steps your team must take to complete 
the project. This task is not only the foundation of project management but also 
a good strategy for determining the resources you will need to complete the 
project successfully and on time. After you have a list of tasks to complete, you 
can begin to plan your project, assign responsibilities, and set deadlines. 

► Plan your project. Planning allows collaborators to develop an effective ap- 
proach and reach agreement before investing a lot of time and resources. 
Planning prevents small problems from becoming big problems with a deadline 
looming. Effective project managers use planning documents such as needs 
analyses, information plans, specifications, and project plans. 

► Create and maintain an accurate schedule. An accurate schedule helps collabo- 
rators plan ahead, allocate their time, and meet deadlines. Update your schedule 
when changes are made, and either place the up-to-date schedule in an easily ac- 
cessible location (for example, on a project website) or send the schedule to each 
team member. If the team misses a deadline, immediately create a new deadline. 
Team members should always know when tasks must be completed. 

► Put your decisions in writing. Writing down your decisions, and communicating 
them to all collaborators, helps the team remember what happened. In addition, 
if questions arise, the team can refer easily to the document and, if necessary, 
update it. 

► Monitor the project. By regularly tracking the progress of the project, the team 
can learn what it has accomplished, whether the project is on schedule, and if 
any unexpected challenges exist. 

► Distribute and act on information quickly. Acting fast to get collaborators the 
information they need helps ensure that the team makes effective decisions and 
steady progress toward completing the project. 

► Be flexible regarding schedule and responsibilities. Adjust your plan and meth- 
ods when new information becomes available or problems arise. When tasks are 
held up because earlier tasks have been delayed or need reworking, the team 
should consider revising responsibilities to keep the project moving forward. 


Conducting Meetings 

Collaboration involves meetings. Whether you are meeting live in a room on 
campus or using videoconferencing tools, the five aspects of meetings dis- 
cussed in this section can help you use your time productively and produce 
the best possible document. 


g== To watch a tutorial on using 
3aSI helpful online tools to 
schedule meetings, go to Ch. 4 > 
Additional Resources > Tutorials: 

macmillanhighered.com 
/launchpad/techcomml 1e. 
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LISTENING EFFECTIVELY 

Participating in a meeting involves listening and speaking. If you listen 
carefully to other people, you will understand what they are thinking 
and you will be able to speak knowledgeably and constructively. Unlike 
hearing, which involves receiving and processing sound waves, listening 
involves understanding what the speaker is saying and interpreting the 
information. 


Follow these five steps to improve your effectiveness as a listener. 

► Pay attention to the speaker. Look at the speaker, and don't let your mind 


► Listen for main ideas. Pay attention to phrases that signal important information, 
such as "What I'm saying is . . ."or"The point I'm trying to make is . . . ." 

► Don't get emotionally involved with the speaker's ideas. Even if you disagree, 
continue to listen. Keep an open mind. Don't stop listening in order to plan what 
you are going to say next. 

► Ask questions to clarify what the speaker said. After the speaker finishes, ask 
questions to make sure you understand. For instance, "When you said that 
each journal recommends different protocols, did you mean that each journal 
recommends several protocols or that each journal recommends a different 
protocol?" 

► Provide appropriate feedback. The most important feedback is to look into the 
speaker's eyes. You can nod your approval to signal that you understand what he 
or she is saying. Appropriate feedback helps assure the speaker that he or she is 
communicating effectively. 


SETTING YOUR TEAM'S AGENDA 

It’s important to get your team off to a smooth start. In the first meeting, 
start to define your team’s agenda. 
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Carrying out these eight tasks will help your team work effectively and efficiently. 

► Define the team's task. Every team member has to agree on the task, the 

deadline, and the approximate length of the document. You also need to agree 
on more conceptual points, including the document's audience, purpose, and 
scope. 
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Listening Effectively 


wander. 



Setting Your Team's Agenda 


(i continued ) 





Conducting Meetings 


► Choose a team leader. This person serves as the link between the team 
and management. (In an academic setting, the team leader represents the 
team in communicating with the instructor.) The team leader also keeps 
the team on track, leads the meetings, and coordinates communication 
among team members. 

► Define tasks for each team member. There are three main ways to divide the 
tasks: according to technical expertise (for example, one team member, an engi- 
neer, is responsible for the information about engineering), according to stages 
of the writing process (one team member contributes to all stages, whereas 
another participates only during the planning stage), or according to sections 
of the document (several team members work on the whole document but oth- 
ers work only on, say, the appendixes). People will likely assume informal roles, 
too. One person might be good at clarifying what others have said, another at 
preventing arguments, and another at asking questions that force the team to 
reevaluate its decisions. 

► Establish working procedures. Before starting to work, collaborators need 
answers — in writing, if possible — to the following questions: 

— When and where will we meet? 

— What procedures will we follow in the meetings? 

— What tools will we use to communicate with other team members, including 
the leader, and how often will we communicate? 

► Establish a procedure for resolving conflict productively. Disagreements 
about the project can lead to a better product. Give collaborators a chance to 
express ideas fully and find areas of agreement, and then resolve the conflict 
with a vote. 

► Create a style sheet. A style sheet defines the characteristics of the document's 
writing style. For instance, a style sheet states how many levels of headings the 
document will have, whether it will have lists, whether it will have an informal 
tone (for example, using "you" and contractions), and so forth. If all collaborators 
draft using a similar writing style, the document will need less revision. And be 
sure to use styles, as discussed in Chapter 3, to ensure a consistent design for 
headings and other textual features. 

► Establish a work schedule. For example, for a proposal to be submitted on 
February 1 0, you might aim to complete the outline by January 25, the draft 
by February 1, and the revision by February 8. These dates are called mile- 
stones. 

► Create evaluation materials. Team members have a right to know how their work 
will be evaluated. In college, students often evaluate themselves and other team 
members. In the working world, managers are more likely to do the evaluations. 


Figure 4.2 shows a work-schedule form. Figure 4.3 on p. 65 shows a team- 
member evaluation form, and Figure 4.4 on p. 66 shows a self-evaluation 
form. 
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FIGURE 4.2 

Work-Schedule Form 


Notice that milestones sometimes 
are presented in reverse chrono- 
logical order; the delivery-date 
milestone, for instance, comes first. 
On other forms, items are presented 
in normal chronological order. 


The form includes spaces for listing 
the person responsible for each 
milestone and progress report and 
for stating the progress toward each 
milestone and progress report. 


For printable versions of 
Figs. 4.2, 4.3, and 4.4, go to 
Ch. 4 > Additional Resources > 
Downloadable Forms: 

macmillanhighered.com 

/launchpad/techcommlle. 


WORK-SCHEDULE FORM 



Name of Project: 

VoIP feasibility study 



Principal Reader: 

Joan 



Other Readers: 

Carlton, Wendy 



Group Members: 

5aada, Larry, Randy, Ahmed 



Type of Document Required: 

recomrPrendation report 



Milestones 

Responsible Member 

Status 

Date 

Deliver Document 

Saada 


May 19 

Proofread Document 

all 


May 13 

x \Send Document to Print Shop 

n/a 


n/a 

Complete Revision 

Randy 


May 17 

Review Draft Elements 

all 

Done 

May 16 

Assemble Draft 

Ahmed 

Done 

May 13 

Establish Tasks 

Larry 

Done 

May 9 

Progress Reports 

Responsible Member 

Status 

Date 

Progress Report 3 

* n/a 



Progress Report 2 

n/a 



Progress Report 1 

Randy 

Done 

May 15 

Meetings 

Agenda Location Date 

Time 

Meeting 3 

Review final draft Room C 

May 1& 

3:30 

Meeting 2 

Review draft elements Room 3 

May 16 

2:00 

Meeting 1 

Kickoff meeting Room C 

May 9 

3:00 

Notes 
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TEAM-MEMBER EVALUATION FORM 

Your name' Mackenzie Hopkins 

Title of the project: - - 

Date: ' ? ? ~ 

Instructions 

Use this form to evaluate the other members of your group. Write the name of 
each group member other than yourself in one of the columns, then assign a score 
of 0 to 10 (0 being the lowest grade, 10 the highest) to each group member for 
each criterion. Then total the scores for each member. Because each group mem- 
ber has different strengths and weaknesses, the scores you assign will differ. On 
the back of this sheet, write any comments you wish to make. 


Criteria 

Team Members 


Ai-vcber 

Bob 


1 . Regularly attends meetings 

2. Is prepared at meetings 

3. Meets deadlines 

4. Contributes good ideas 
in meetings 

5. Contributes ideas 
diplomatically 

6. Submits high-quality work 

7. Listens to other members 

8. Shows respect for 
other members 

9. Helps to reduce conflict 

10. Your overall assessment of 
this person’s contribution 

1. 10 

1. 9 

1. 

1. 

2. 

2. O 

2. 5 

2. 

3. 9 

3. 9 

3. 2 

3. 

4. 9 

4 l< 

4. 9 

4. 

5. & 

S. 9 

5. 9 

5. 

6. 9 

6. 9 

6. 7 

6. 

7. 

7. K 

7. 

7. 

8. 9 

8 10 

8. 6 

8. 

9. 

9 10 

9. 

9. 

10. 9 

10. 9 

10. 7 

10. 





Total Points 










FIGURE 4.3 

Team-Member 
Evaluation Form 


Mackenzie gives high grades to 
Kurt and Amber but low grades to 
Bob. If Kurt and Amber agree with 
Mackenzie's assessment of Bob's 
participation, the three of them 
should meet with Bob to discuss 
why his participation has been 
weak and to consider ways for him 
to improve. 
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FIGURE 4.4 

Self-Evaluation Form 


The evaluation section of the 
form is difficult to fill out, but it 
can be the most valuable section 
for you in assessing your skills in 
collaborating. When you get to the 
second question, be thoughtful and 
constructive. Don't merely say that 
you want to improve your skills in 
using the software. And don't just 
write "None." 


SELF-EVALUATION FORM 

Your name: ; -- -■■■-- Date: T 5 

Title of the project: -A'p 1 j , - ,;f 

Instructions 

On this form, record and evaluate your own involvement in this project. In the Log 
section, record the activities you performed as an individual and those you per- 
formed as part of the team. For all activities, record the date and the number of 
hours you spent. In the Evaluation section, write two brief statements, one about 
aspects of your contribution you think were successful and one about aspects you 
want to improve. 


Log 

Individual Activities 

Reviewed proposal and analyzed the Simmons article 
Wrote a draft of the progress report 
Revised a draft of the progress report 

Date 

April 9 

April 10 
April 11 

Number 
of Hours 

1.5 

2.5 
1 

Activities as Part of Team 

Met to discuss test research 

Emailed group and replied to questions about draft 
Met to discuss revision of progress report 

Date 

April 10 

April 11 
April 11 

Number 
of Hours 

f 

2.5 

1.5 

Evaluation 

Aspects of My Participation That Were Successful 

1 think 1 did a good job in reviewing the proposal and critiquing the research. 1 had the 
draft ready on time, although there were some rough parts in it. 1 participated effectively 
in the group meeting about the revision. 1 think I'm getting a little better about being less 
sensitive when the team suggests revisions. 

Aspects of My Participation That 1 Want to Improve in the Future 

1 still need to get better at completing my work early enough so 1 can set it aside before getting 
it out to the other group members. 1 get embarrassed when they point out superficial mistakes 
that 1 should have caught. 1 need to practice using styles so that my drafts are easier to 
incorporate into the group's draft. The other members remembered to use them. 1 didn't. 
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ETHICS NOTE 


PULLING YOUR WEIGHT ON COLLABORATIVE PROJECTS 

Collaboration involves an ethical dimension. If you work hard and well, you help the other 
members of the team. If you don't, you hurt them. 

You can't be held responsible for knowing and doing everything, and sometimes unexpected 
problems arise in other courses or in your private life that prevent you from participating as 
actively and effectively as you otherwise could. When problems occur, inform the other team 
members as soon as possible. For instance, call the team leader as soon as you realize you will 
have to miss a meeting. Be honest about what happened. Suggest ways you might make up 
for missing a task. If you communicate clearly, the other team members are likely to cooperate 
with you. 

If you are a member of a team that includes someone who is not participating fully, keep rec- 
ords of your attempts to get in touch with that person. When you do make contact, you owe it 
to that person to try to find out what the problem is and suggest ways to resolve it. Your goal is 
to treat that person fairly and to help him or her do better work, so that the team will function 
more smoothly and more effectively. 


For a discussion of meeting minutes, 
seeCh. 17, p.464. 

COMMUNICATING DIPLOMATICALLY 

Because collaborating can be stressful, it can lead to interpersonal conflict. 

People can become frustrated and angry with one another because of per- 
sonality clashes or because of disputes about the project. If the project is to 
succeed, however, team members have to work together productively. When 
you speak in a team meeting, you want to appear helpful, not critical or over- 
bearing. 

CRITIQUING A TEAM MEMBER'S WORK 

In your college classes, you probably have critiqued other students’ writing. 

In the workplace, you will do the same sort of critiquing of notes and drafts 
written by other team members. Knowing how to do it without offending the 
writer is a valuable skill. 


CONDUCTING EFFICIENT MEETINGS 

Human communication is largely nonverbal. That is, although people com- 
municate through words and through the tone, rate, and volume of their 
speech, they also communicate through body language. For this reason, 
meetings provide the most information about what a person is thinking and 
feeling — and the best opportunity for team members to understand one 
another. 

To help make meetings effective and efficient, team members should 
arrive on time and stick to the agenda. One team member should serve as 
secretary, recording the important decisions made at the meeting. At the end 
of the meeting, the team leader should summarize the team’s accomplish- 
ments and state the tasks each team member is to perform before the next 
meeting. If possible, the secretary should give each team member this infor- 
mal set of meeting minutes. 
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Communicating Diplomatically 


These seven suggestions for communicating diplomatically will help you communi- 
cate effectively. 

► Listen carefully, without interrupting. See the Guidelines box on page 62. 

► Give everyone a chance to speak. Don't dominate the discussion. 

► Avoid personal remarks and insults. Be tolerant and respectful of other people's 
views and working methods. Doing so is right — and smart: if you anger people, 
they will go out of their way to oppose you. 

► Don't overstate your position. A modest qualifier such as"l think"or"it seems to 
me" is an effective signal to your listeners that you realize that everyone might 
not share your views. 

overbearing My plan is a sure thing; there's no way we're not going to kill Allied 
next quarter. 

diplomatic I think this plan has a good chance of success: we're playing off our 
strengths and Allied's weaknesses. 

Note that in the diplomatic version, the speaker says "this plan," not "my plan." 

► Don't get emotionally attached to your own ideas. When people oppose you, 
try to understand why. Digging in is usually unwise — unless it's a matter of 
principle — because, although it's possible that you are right and everyone else is 
wrong, it's not likely. 

► Ask pertinent questions. Bright people ask questions to understand what they 
hear and to connect it to other ideas. Asking questions also encourages other 
team members to examine what they hear. 

► Pay attention to nonverbal communication. Bob might say that he understands 
a point, but his facial expression might show that he doesn't. If a team member 
looks confused, ask him or her about it. A direct question is likely to elicit a state- 
ment that will help the team clarify its discussion. 


Most people are very sensitive about their writing. Following these three sugges- 
tions for critiquing writing will increase the chances that your colleague will consider 
your ideas positively. 

► Start with a positive comment. Even if the work is weak, say, "You've obviously 
put a lot of work into this, Joanne. Thanks." Or, "This is a really good start. Thanks, 
Joanne." 

► Discuss the larger issues first. Begin with the big issues, such as organization, 
development, logic, design, and graphics. Then work on smaller issues, such as 
paragraph development, sentence-level matters, and word choice. Leave editing 
and proofreading until the end of the process. 
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Critiquing a Colleague's Work 


(i continued ) 






Using Social Media and Other Electronic Tools in Collaboration 


► Talk about the document, not the writer. 

rude You don't explain clearly why this criterion is relevant. 

better I'm having trouble understanding how this criterion relates to the 

topic. 

Your goal is to improve the quality of the document you will submit, not to evalu- 
ate the writer or the draft. Offer constructive suggestions. 

rude Why didn't you include the price comparisons here, as you said you 

would? 

better I wonder if the report would be stronger if we included the price 

comparisons here. 

In the better version, the speaker focuses on the goal (to create an effective 
report) rather than on the writer's draft. Also, the speaker qualifies his recommen- 
dation by saying, "I wonder if . . . ." This approach sounds constructive rather than 
boastful or annoyed. 


Using Social Media and Other 
Electronic Tools in Collaboration 

The tremendous growth in the use of social-media services such as Face- 
book, YouTube, and Twitter by the general population is reflected in the 
working world. Although few of the social-media tools were created for 
use in that context, most of them are used by professionals as business 
tools. 

With each passing year, more professionals are using social media in 
the workplace. A 2012 survey by the human-resources consulting com- 
pany SilkRoad found that almost three-quarters of employees surveyed 
use their own mobile devices in the workplace every day to connect with 
co-workers and customers, to share work-related information, to collabo- 
rate, and to spark new ideas. The three most popular services were Twitter, 
Facebook, and Linkedln, each used by more than half of those surveyed. 

By contrast, company-sponsored tools, such as intranets, were used by 
less than one-fifth of respondents. Email is still the most popular com- 
munication tool, used by more than 80 percent of respondents; no other 
company-sponsored tool was used by even 50 percent of respondents 
(SilkRoad, 2013). 

Professionals use many types of electronic tools to exchange informa- 
tion and ideas as they collaborate. The following discussion highlights 
the major technologies that enable collaboration: word-processing tools, 
messaging technologies, videoconferencing, wikis and shared document 
workspaces, and virtual worlds. 
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► TECH TIP 


How To Use the Review Tab 


When collaborating with others, you can distribute your document to readers electronically so that they can add comments, revise 
text, and highlight text. You can then review their comments, keep track of who made which changes, compare two versions, and 
decide whether to accept or decline changes without ever having to print your document. You can use the Review tab to elec- 
tronically review a document or to revise a document that has already been commented on by readers. 


1 . Select the Review tab to access the Comments, 
Tracking, Changes, and Compare groups. 

2. To electronically review a document, highlight 
the relevant text and do the following: 


n 

New 

£3 Delete v 
Previous 

Comment 

£3 Next 

Comments 


je Layout References Mailings [ Review | View 

23 Delete * 
K £3 Previous 
Comment £3 Next 
Comments 

Track 
Changes - 

Final: Show Markup 
[§ Show Markup » 
fg»l Reviewing Pane » 
Tracking 

Previous 

Accept j-. 

* ^ Next 

Changes 

□ 

Compare 

Compare 


Select the New Comment 

button in the Comments 
group to write comments in a 
bubble in the margin. 


Select the Track Changes button to 
distinguish between revised text and 
original text. 


On the Home tab in the Font group, select 
the Text Highlight button to emphasize a 
particular passage. 


Aniwenag the Cental Research Questions 

Regarding the few- e tv -e a d - b ykgr ocnd of the white paper geese, we have seen that 
the white paper began in Britain as a statement of government policy. The term was later 
| applied to teelawjal-donments describing aspects of the development and use of atomic 
weapons in the Manhattan Project fc>f World War II- While white ji^es continue to be ... 
used as descriptive and explanatory documents tn various technical fields, the term was 
| ip;:^£ is 104 doruiMMl m the !W0i Hocunsrai 

shared with select customers to aid the sales and marketing process. The technology 
toom of the 1960s and 1990s led vendors to use white papers as technical marketing 

documents foe educating prospective customers. As the technoioft- sector has become 




- c-~ 




•*" ► □ v ***** ' 
□ L+1 Cm*. * 




To change the color or 
design of comment 
bubbles or markup, select 

the Track Changes button 
in the Tracking group, 
and select Change 
Tracking Options. The 
Track Changes Options 
dialog box will appear. 


3. To revise a document that has already been commented 
on by reviewers, you can do the following: 


Use the Tracking group to change how 
the document is displayed. 


Review View 


Final: Show Markup 


Final: Show Markup 


Final 

Original: Show Markup 
Original 


Select buttons in the Changes group to 
see the previous or next comment and 

to accept or reject a change. 


Accept 


^ Reject * 
Previous 
$>Next 
Changes 


Select the Reviewing — 
Pane button to review all 
comments and changes. 


|j£] Reviewing 


| Accei 


El Reviewing Pane Vertical... 

3 Reviewing Pane Horizontal... 



KEYWORDS: review tab, comments group, tracking group, 
changes group, compare group 
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WORD-PROCESSING TOOLS 

Most word processors offer three powerful features that you will find useful 
in collaborative work: 

• The comment feature lets readers add electronic comments to a file. 

• The revision feature lets readers mark up a text by deleting, revising, and 
adding words and indicates who made which suggested changes. 

• The highlighting feature lets readers use one of about a dozen “highlighting 
pens” to call the writer’s attention to a particular passage. 

MESSAGING TECHNOLOGIES 

Two messaging technologies have been around for decades: instant mes- 
saging and email. Instant messaging (IM) is real-time, text-based commu- 
nication between two or more people. In the working world, IM enables 
people in different locations to communicate textual information at the 
same time. Email is an asynchronous medium for sending brief textual 


To watch a tutorial on using 
the commenting features in 
Word, Adobe Acrobat, and Google 
Drive, go to Ch. 4 > Additional 
Resources > Tutorials: 
macmillanhighered.com 
/launchpad/techcomml 1e. 

[1^ To watch a tutorial on 
I incorporating tracked 
changes, go to Ch. 4 > Additional 
Resources > Tutorials: 

macmillanhighered.com 
/launchpad/techcomml 1e. 


DOCUMENT ANALYSIS ACTIVITY 


Critiquing a Draft Clearly and Diplomatically 

This is an excerpt from the methods section of a report about computer servers. In this section, the writer is explaining the tasks he 

performed in analyzing different servers. In a later section, he explains what he learned from the analysis. The comments in the balloons 

were inserted into the document by the author's colleague. 

The questions in the margin ask you to think about techniques for critiquing (as outlined on page 68). 

1 . What is the tone of the com- 
ments? How can they be 
improved? 

2 . How well does the 
collaborator address the 
larger issues? 

3 . How well does the collabo- 
rator address the writing, 
not the writer? 

4 . How well do the collabora- 
tor's comments focus on the 
goal of the document, rather 
than judging the quality of 
the writing? 


The first task of the on-site evaluations was to set up and configure 
each server. We noted the relative complexity of setting up each 
system to our network. 


After we had the system configured, we performed a set of routine 
maintenance tasks: add a new memory module, swap a hard drive, 
swap a power supply, and perform system diagnostics. 


We recorded the time and relative difficulty of each task. Also, we 
tried to gather a qualitative feeling for how much effort would be 
involved in the day-to-day maintenance of the systems. 


After each system was set up, we completed the maintenance 
evaluations and began the benchmark testing. We ran the 
complete WinBench and NetBench test suites on each system. 

We chose several of the key factors from these tests for comparison. 


Comment: Huh? 
What exactly does 
this mean? 


Comment: Okay, good. 
Maybe we 
should explain why 
we chose these tests. 


Comment: What kind of 
scale are you using? If 
we don’t explain it, it’s 
basically useless. 


Comment: Same ques- 
tion as above. 


Comment: Will readers 
know these are the 
right tests? Should we 
explain? 





72 


WRITING COLLABORATIVELY 


For more about writing email, see 
Ch. 14, p. 374. 


To watch a tutorial on using 
videoconferencing software 
to conduct online meetings, 
go to Ch. 4 > Additional 
Resources > Tutorials: 
macmillanhighered.com 
/launchpad/techcomml 1e. 


messages and for transferring files such as documents, spreadsheets, 
images, and videos. 

In the last decade, several new messaging technologies have been intro- 
duced that are well-suited for use on mobile devices such as phones. Of 
these, the two most popular are text messaging and microblogging. 

Text messaging enables people to use mobile devices to send messages 
that can include text, audio, images, and video. Texting is the fastest-growing 
technology for exchanging messages electronically because most people 
keep their phones nearby. Organizations use text messaging for such pur- 
poses as sending a quick update or alerting people that an item has been 
delivered or a task completed. On your campus, the administration might use 
a texting system to alert people about a campus emergency. 

Microblogging is a way of sending very brief textual messages to your 
personal network. You probably use the world’s most popular microblog, 
Twitter, which now has more than half a billion users. Although some 
organizations use Twitter, many use Twitter-like microblogs such as Yam- 
mer, which includes a search function and other features and which can 
be administered from within an organization. 

VIDEOCONFERENCING 

Videoconferencing technology allows two or more people at different loca- 
tions to simultaneously see and hear one another as well as exchange docu- 
ments, share data on computer displays, and use electronic whiteboards. 
Systems such as Skype are simple and inexpensive, requiring only a Webcam 
and some free software. However, there are also large, dedicated systems that 
require extensive electronics, including cameras, servers, and a fiber-optic 
network or high-speed telephone lines. 


4 \ 


GUIDELINES 


Participating in a Videoconference 


Follow these six suggestions for participating effectively in a videoconference. 


► Practice using the technology. For many people, being on camera is uncomfort- 
able, especially the first time. Before participating in a high-stakes videoconfer- 
ence, become accustomed to the camera by participating in a few informal 
videoconferences. 


► Arrange for tech support at each site. Participants can quickly become impatient 
or lose interest when someone is fumbling to make the technology work. Each 
site should have a person who can set up the equipment and troubleshoot if 
problems arise. 


{ continued ) 
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FIGURE 4.5 A Videoconference 

Videoconferencing systems range from sophisticated ones like this to inexpensive cameras 
attached to individual workstations to systems that work on smartphones. Most videoconferencing 
systems can display more than one window to accommodate several sets of participants. 

Source: Cisco, 201 1 : www.cisco.com/c/en/us/products/collateral/collaboration-endpoints/telepresence-txl 300-series/data 
_sheet_c78-712079.html. Courtesy of Cisco Systems, Inc. 


► Organize the room to encourage participation. If there is more than one person 
at the site, arrange the chairs so that they face the monitor and camera. Each per- 
son should be near a microphone. Before beginning the conference, check that 
each location has adequate audio and video as well as access to other relevant 
technology such as computer monitors. Finally, remember to introduce everyone 
in the room, even those off camera, to everyone participating in the conference. 

► Make eye contact with the camera. Eye contact is an important element of 
establishing your professional persona. The physical setup of some videocon- 
ferencing systems means you will likely spend most of your time looking at your 
monitor and not directly into the camera. However, this might give your viewers 
the impression that you are avoiding eye contact. Make a conscious effort peri- 
odically to look directly into the camera when speaking. 

► Dress as you would for a face-to-face meeting. Wearing inappropriate clothing 
can distract participants and damage your credibility. 

► Minimize distracting noises and movements. Sensitive microphones can mag- 
nify the sound of shuffling papers, fingers tapping on tables, and whispering. 
Likewise, depending on your position in the picture frame, excessive movements 
can be distracting. 
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g^= To watch a tutorial on using 
1 wikis for collaborative work, 
go to Ch. 4 > Additional Resources 
> Tutorials: macmillanhighered 
.com/launchpad/techcommlle. 


WIKIS AND SHARED DOCUMENT WORKSPACES 

Ten years ago, people would collaborate on a document by using email to send it 
from one person to another. One person would write or assemble the document 
and then send it to another person, who would revise it and send it along to the 
next person, and so forth. Although the process was effective, it was inefficient: 
only one person could work on the document at any given moment. Today, two 
new technologies — wikis and shared document workspaces — make collaborat- 
ing on a document much simpler and more convenient. 

A wiki is a web-based document that authorized users can write and edit. 
The best-known wiki is Wikipedia, an online encyclopedia that contains 
some four million articles written and edited by people around the world. In 
the working world, people use software such as Jive and Socialtext to host 
wikis used for creating many kinds of documents, such as instructions, man- 
uals, lists of frequently asked questions, and policy documents. For instance, 
many organizations create their policies on using social media by setting up 
wikis and inviting employees to write and edit what others have written. The 
concept is that a wiki draws on the expertise and insights of people through- 
out the organization and, sometimes, outside the organization. Figure 4.6 
shows a portion of a wiki. 


This portion of a screen from 
wikiHow shows an excerpt from an 
article about how to add an 
HP printer to a wireless network. 
Users can click on the Edit tab or 
Edit buttons to edit the article 
and on the Discuss tab to post 
questions and answers. 




wikiHow 

to do anything 


Home » Categories > Computers and Etectronscs > Networking > Wireless Networking 

How to Add an HP Printer to a Wireless 
Network 

Edsed by Kin;. Tom Viren. GameMastcr. Sen Rubenstein and 21 others 


| Article 

/ Edit 

Discuss 

J 

A — - — • 

J L 


rrn ho? 12 | 

Vtnll Rite g *1 | 


HP printers can be added to your network in a number ot ways, depending on the model of printer 
and your network configuration. We'll show you a few ways to do that. Before you get started, make 
sure your printer, computer, and network are turned on. functioning properly, and ready for action. 


Steps 


Method One: Using HP Auto Wireless Connect 

O Verify that your configuration is compatible with HP Auto Wireless Connect, in 

order to use this method, your computer and network configuration must meet the following 
requirements: 


FIGURE 4.6 A Wiki 

From WikiHow of "HowTo Add an HP Printer to a Wireless Network." Reprinted by permission of WikiHow. 
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A shared document workspace makes it convenient for a team of users to 
edit a file, such as a Prezi or PowerPoint slide set or a Word document. A 
shared document workspace such as Microsoft SharePoint or Google Drive 
archives all the revisions made by each of the team members, so that the 
team can create a single document that incorporates selected revisions. 
Some shared document workspaces enable a user to download the docu- 
ment, revise it on his or her computer, and then upload it again. This feature 
is extremely convenient because the user does not need to be connected to 
the Internet to work on the document. 


To watch a tutorial on using 
H collaboration software, 
go to Ch. 4 > Additional Resources 
> Tutorials: macmillanhighered 
.com/launchpad/techcomm 1 1 e. 


VIRTUAL WORLDS 

Organizations are using virtual worlds, such as Second Life, to conduct 
meetings and conferences. Participants create avatars and visit different 
locations in the virtual world to view displays, watch product demonstra- 
tions, hold meetings, participate in job interviews, and talk with others. Many 
people think that entering a three-dimensional virtual world, in which you 
can talk with others through a headset connected to a computer, creates a 
more realistic experience than merely visiting a website, watching a video, 
or talking on the phone. Companies such as IBM, Cisco, and Intel use virtual 
worlds such as Second Life and Open Sim for day-to-day activities and spe- 
cial events. Holding a conference for 200 employees on Second Life saved IBM 
some $320,000 in transportation, food, and lodging expenses (Martin, 2012). 
Figure 4.7 shows how one company uses a virtual world to display a product. 



Avatars of prospective customers 
are examining a model created 
by a design firm. The avatars can 
walk around and view the model 
from any perspective. The design 
firm even has full-scale models of 
houses. Avatars can enter a house, 
examine the interior, and then sit 
down in a virtual room with the 
firm's representatives to discuss 
the design. The firm can change 
the design in real time in response 
to customers' questions and 
suggestions. 


FIGURE 4.7 A Virtual World 

From www.crescendodesign.com. Reprinted by permission of Crescendo Design. 
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Although this section has discussed various collaboration tools as sepa- 
rate technologies, software companies are bundling programs in commercial 
products such as IBM Sametime, Adobe Creative Cloud, and Microsoft Lync, 
which are suites of voice, data, and video services. These services usually 
share four characteristics: 

• They are cloud based. That is, organizations lease the services and access 
them over the Internet. They do not have to acquire and maintain special 
hardware. This model is sometimes called software as a service. 

• They are integrated across desktop and mobile devices. Because employees 
can access these services from their desktops or mobile devices, they are 
free to collaborate in real time even if they are not at their desks. Some 
services provide presence awareness, the ability to determine a person’s 
online status, availability, and geographic location. 

• They are customizable. Organizations can choose whichever services they 
wish and then customize them to work effectively with the rest of the 
organization’s electronic infrastructure, such as computer software and 
telephone systems. 

• They are secure. Organizations store the software behind a firewall, 
providing security: only authorized employees have access to the services. 


For more about maintaining a 
professional presence online, see 
Ch. 2, p. 33. 


ETHICS NOTE 


MAINTAINING A PROFESSIONAL PRESENCE ONLINE 

According to a report from Cisco Systems (2010), half of the surveyed employees claim to rou- 
tinely ignore company guidelines that prohibit the use of social media for non-work-related 
activities during company time. If you use your organization's social media at work, be sure 
to act professionally so that your actions reflect positively on you and your organization. Be 
aware of several important legal and ethical issues related to social media. 

Although the law has not always kept pace with recent technological innovations, a few things 
are clear. You and your organization can be held liable if you make defamatory statements 
(statements that are untrue and damaging) about people or organizations, publish private 
information (such as trade secrets) or something that publicly places an individual "in a false 
light," publish personnel information, harass others, or participate in criminal activity. 

In addition, follow these guidelines to avoid important ethical pitfalls: 

• Don't waste company time using social media for nonbusiness purposes. You owe your em- 
ployer diligence (hard work). 

• Don't divulge secure information, such as a login and password that expose your organiza- 
tion to unauthorized access, and don't reveal information about products that have not yet 
been released. 

• Don't divulge private information about anyone. Private information relates to such issues 
as religion, politics, and sexual orientation. 

• Don't make racist or sexist comments or post pictures of people drinking. 

If your organization has a written policy on the use of social media, study it carefully. Ask ques- 
tions if anything in it is unclear. If the policy is incomplete, work to make it complete. If there 
is no policy, work to create one. 

For an excellent discussion of legal and ethical aspects of using your organization's social me- 
dia, see Kaupins and Park (2010). 




Culture and Collaboration 


Gender and Collaboration 

Effective collaboration involves two related challenges: maintaining the team 
as a productive, friendly working unit and accomplishing the task. Scholars 
of gender and collaboration see these two challenges as representing the 
feminine and the masculine perspectives. 

This discussion should begin with a qualifier: in discussing gender, we 
are generalizing. The differences in behavior between two men or between 
two women are likely to be greater than the differences between men and 
women in general. 

The differences in how the genders communicate and work in teams have 
been traced to every culture’s traditional family structure. Because women 
were traditionally the primary caregivers in American culture, they learned 
to value nurturing, connection, growth, and cooperation; because men were 
the primary breadwinners, they learned to value separateness, competi- 
tion, debate, and even conflict (Karten, 2002). In collaborative teams, women 
appear to value consensus and relationships more than men do, to show 
more empathy, and to demonstrate superior listening skills. Women talk 
more about topics unrelated to the task (Duin, Jorn, & DeBower, 1991), but 
this talk is central to maintaining team coherence. Men appear to be more 
competitive than women and more likely to assume leadership roles. Schol- 
ars of gender recommend that all professionals strive to achieve an androgy- 
nous mix of the skills and aptitudes commonly associated with both women 
and men. 


Culture and Collaboration 

Most collaborative teams in industry and in the classroom include people 
from other cultures. The challenge for all team members is to understand 
the ways in which cultural differences can affect team behavior. People from 
other cultures 

• might find it difficult to assert themselves in collaborative teams 

• might be unwilling to respond with a definite “no” 

• might be reluctant to admit when they are confused or to ask for 
clarification 

• might avoid criticizing others 

• might avoid initiating new tasks or performing creatively 

Even the most benign gesture of friendship on the part of a U.S. student can 
cause confusion. If a U.S. student casually asks a Japanese student about her 
major and the courses she is taking, the Japanese student might find the ques- 
tion too personal — yet she might consider it perfectly appropriate to talk about 
her family and her religious beliefs (Lustig & Koester, 2012). Therefore, you 
should remain open to encounters with people from other cultures without 
jumping to conclusions about what their actions might or might not mean. 
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For more about multicultural issues, 
see Ch. 5, p. 95. 
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WRITER'S CHECKLIST 


In managing your project, did you 

CD break it down into several smaller tasks if it was large? 

(P- 61) 

□ create a plan? (p. 61) 

□ create and maintain an accurate schedule? (p.61) 

I I put your decisions in writing? (p.61) 

□ monitor progress? (p.61) 

I distribute and act on information quickly? (p.61) 

□ act flexibly regarding schedule and responsibilities? 

(p.61) 

At your first team meeting, did you 
I ] define the team's task? (p. 62) 

CD choose a team leader? (p. 63) 

I ] define tasks for each team member? (p. 63) 

CD establish working procedures? (p. 63) 

I I establish a procedure for resolving conflict productively? 

(p. 63) 

□ create a style sheet? (p. 63) 

CD establish a work schedule? (p. 63) 

□ create evaluation materials? (p. 63) 

To help make meetings efficient, do you 

□ arrive on time? (p. 67) 

CD stick to the agenda? (p. 67) 

I ] make sure that a team member records important 

decisions made at the meeting? (p. 67) 

CD make sure that the leader summarizes the team's 

accomplishments and that every member understands 
what his or her tasks are? (p. 67) 


To communicate diplomatically, do you 

! I listen carefully, without interrupting? (p. 68) 

I give everyone a chance to speak? (p. 68) 

CD avoid personal remarks and insults? (p. 68) 

CD avoid overstating your position? (p. 68) 

CD avoid getting emotionally attached to your own ideas? 
(p. 68) 

CD ask pertinent questions? (p. 68) 

□ pay attention to nonverbal communication? (p. 68) 

In critiquing a team member's work, do you 

□ start with a positive comment? (p. 68) 

I discuss the larger issues first? (p. 68) 

□ talk about the document, not the writer? (p. 69) 

□ use the comment, revision, and highlighting features of 
your word processor, if appropriate? (p. 71) 

When you participate in a videoconference, do you 

CD first practice using videoconferencing technology 
(P- 72) 

□ arrange for tech support at each site? (p. 72) 

□ organize the room to encourage participation? (p. 73) 

CD make eye contact with the camera? (p. 73) 

CD dress as you would for a face-to-face meeting? (p. 73) 

□ minimize distracting noises and movements? (p. 73) 


EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . Experiment with the comment, revision, and 

highlighting features of your word processor. Using 
online help if necessary, learn how to make, revise, and 
delete comments; make, undo, and accept revisions; 
and add and delete highlights. 


2. Locate free videoconferencing software on the Internet. 
Download the software, and install it on your computer 
at home. Learn how to use the feature that lets you send 
attached files. 

3. Using a wiki site such as wikiHow.com, find a set of 
instructions on a technical process that interests you. 






Study one of the revisions to the instructions, noting 
the types of changes made. Do the changes relate to 
the content of the instructions, to the use of graphics, or 
to the correctness of the writing? Be prepared to share 
your findings with the class. 

4. Sign up for a free account on Second Life. Choose 
an avatar, learn how to navigate on the site, and see 
whether your university has any academic offerings on 
the grid. If not, learn how you and a few members of the 
class could use Second Life to meet and work as a team. 

5. TEAM EXERCISE If you are enrolled in a technical- 
communication course that calls for you to do a large 
collaborative project, such as a recommendation report 
or an oral presentation, meet with your team members. 
Study the assignment for the project, and then fill out 
the work-schedule form. (You can download the 

form from macmillanhighered.com/launchpad 
/techcommlle.) Be prepared to share your completed 
form with the class. 

6. You have probably had a lot of experience working in 
collaborative teams in previous courses or on the job. 
Brainstorm for five minutes, listing some of your best 
and worst experiences participating in collaborative 
teams. Choose one positive experience and one 
negative experience. Think about why the positive 
experience went well. Was there a technique that a 
team member used that accounted for the positive 
experience? Think about why the negative experience 
went wrong. Was there a technique or action that 


accounted for the negative experience? How might the 
negative experience have been prevented — or fixed? Be 
prepared to share your responses with the class. 

7. TEAM EXERCISE Your college or university wishes 
to update its website to include a section called 
"For Prospective International Students." Along with 
members of your team, first determine whether your 
school already has information of particular interest 
to prospective international students. If it does, write 
a memo to your instructor describing and evaluating 
the information. Is it accurate? Comprehensive? Clear? 
Useful? What kind of information should be added to 
the site to make it more effective? 

If the school's site does not have this information, 
perform the following two tasks: 

• Plan. What kind of information should this new 
section include? Does some of this information 
already exist elsewhere on the Web, or does it all 
have to be created from scratch? For example, can 
you create a link to an external site with information 
on how to obtain a student visa? Write an outline of 
the main topics that should be covered. 

• Draft. Write the following sections: "Where to 
Live on or near Campus," "Social Activities on or 
near Campus," and "If English Is Not Your Native 
Language." What graphics could you include? Are 
they already available? What other sites should you 
link to from these three sections? 

In a memo, present your suggestions to your instructor. 


fpjji For more practice with the concepts covered in Chapters 1 -4, 

M complete the LearningCurve activity "Understanding the 
Technical Communication Environment" under "Additional Resources" 

in Ch. 4: macmillanhighered.com/launchpad/techcomm11e. 


CASE 4: Accommodating aTeam Member's Scheduling Problems 


Your technical-communication instructor has organized you into groups of three in which 
you will collaborate on a series of projects throughout the semester. Before your first 
assignment is due, you learn that one team member must deal with a family emergency 
that will interfere with his ability to participate in the project for some time. Now, you and 
your other teammate must devise a plan to proceed with the project. You also decide to 
propose a classwide policy for communicating with teammates when problems arise. 

To get started on your assignment, go to "Cases" under "Additional Resources" in Ch. 4: 
macmillanhighered.com/launchpad/techcomm1 1 e. 
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JASON FALLS, THE DIGITAL STRATEGIST for the online retailer CafePress, 
writes frequently about how companies can use social media to create 
relationships with customers. What does he say is the key to using social media 
for business? Knowing your audience. In a 201 3 blog post, Falls wrote about 
some of the electronic services that can help companies figure out who their 
customers are so that they can better appeal to their interests. One of the services 
he discussed is DemographicsPro, which supplies information about yourTwitter 
followers. Figure 5.1 shows part of the report that DemographicsPro supplied to 
Falls about his Twitter followers. 

Organizations of all sorts, not just businesses, analyze their audiences. 
Government agencies that want to appeal to the general public — to urge them 
to eat better, get vaccinated, or sign up for health insurance, to name just a 


AUDIENCE STATS > 

Audience Profile for @JasonFalls 

THEY EAT AT > 

Audience: 55,504 people 
Gender 54.2% male 
Age: 37.5 years 

©JasonFalls's followers are in their late thirties, typically 
white/caucasians married with children and with very high 
income.The account has a particularly strong audience 
concentration in New York. 

Professionally, @JasonFalls's followers are senior 
managers, entrepreneurs, consultants, HR professionals and 
administrative staff. The account ranks within the top 10% of 
all Twitter accounts in terms of density of sales/marketing 

& Cjdtix* 

CmUm ~ 

«&>§» asswt ® 

Income: $69.6K/year 

THEY SHOP AT t> 


TWITTER ACTIVITY ► 

Crate Barrel n - r ■ 

They tweet: 7.3 times a week 
They have: 721 followers 

managers. Analysis... 

m . In their spare time they particularly enjoy political news, 
wine, yoga, art/culture and eating out. People following 

n is m 

They follow: 1 ,069 accounts 

@JasonFalls are charitably generous, environmentally aware 

THEY'RE DRESSED BY > 

and particularly health conscious. Sports enjoyed significantly 


AUDIENCE LOCATION > 

more than Twitter norm include cycling hockey and skiing 
Analysis... 


Mostly United States (73.6%), 
with top cities: 
o New York (6.2%) 

9 London (3.4%) 

a As consumers they are affluent and fashion conscious, with 
9 spending focused most strongly on technology, wining/dining 


and home/family. Their strongest main street brand affiliations 

THEY USE ▻ 

include Caribou Coffee, Trader Joe's, Crate and Barrel, 
Container Store and P.F. Chang's. Analysis... 

Shoougite © Sttsnic Linked Q 

9 Chicago (3.1%) 

9 San F^ndsco (2.7%) 

On Twitter they tweet less than average yet are relatively 
Influential. Accounts followed far more than Twitter average 
include @mashable, @hootsuite, @TechCrunch, ©garyvee 
and ©adage. Analysis... 

oboutmo paper, li 




FIGURE 5.1 Analysis of Twitter Followers 

Source: Falls, 2013: http://www.socialmediaexplorer.com/wp-content/uploads/2013/04/demopro-falls.jpg. Reprinted by 
permission of Social Media Explorer. 
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ANALYZING YOUR AUDIENCE AND PURPOSE 


few campaigns — start by analyzing their audiences to learn how to motivate 
them. Political campaigns analyze voters to determine the issues they want to 
see addressed. Charities such as the March of Dimes analyze their audiences to 
improve the effectiveness of their communications. 


Understanding Audience and Purpose 

Projects and campaigns of all sizes and types succeed only if they are based 
on an accurate understanding of the needs and desires of their audiences 
and have a clear, focused purpose. Because the documents and other com- 
munication you produce in the workplace will, more often than not, form 
the foundations of these projects and campaigns, they too will succeed only 
if they are based on an accurate understanding of your audience and have a 
clear purpose. 

Although you might not realize it, you probably consider audience in your 
day-to-day communication. For example, when you tell your parents about 
a new job you’ve landed, you keep the discussion general and focus on the 
job details you know they care most about: its location, its salary and ben- 
efits, and your start date. But when you email a former internship supervisor 
with the same news, you discuss your upcoming duties and projects in more 
detail. 

As you produce documents for this technical-communication course, you 
will of course consider your instructor’s expectations, just as you do when 
you write anything for any other course. But keep in mind that your instruc- 
tor in this course is also playing the role of the audience that you would be 
addressing if you had produced the document outside of this college course. 
Therefore, to a large extent your instructor will likely evaluate each of your 
course assignments on how effectively you’ve addressed the audience and 
achieved the purpose specified in the assignment. 

Analyzing an audience means thinking about who your audience is, what 
they already know about your subject, how they feel about it, and how they 
are going to use the information you present. You analyze your audience as 
you plan your document so that it appeals to their interests and needs, is 
easy for them to understand, and motivates them to pay attention to your 
message and consider your recommendations. 

The word purpose refers to what you want to accomplish with the docu- 
ment you are producing. Most often, your purpose is to explain to your 
audience how something occurs (how regenerative braking systems work in 
hybrid cars), how to carry out a task (how to set up a Skype connection), or 
why some situation is either good or bad (why the new county guidelines for 
water use will help or hurt your company). When your purpose is to explain 
why a situation is either good or bad, you are trying to reinforce or change 
the audience’s attitudes toward the situation and perhaps urge them to take 
action. 
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Before you can start to think about writing about your subject, analyze your 
audience and purpose. Doing so will help you meet your readers’ needs — and 
your own. For instance, you’re an engineer working for a consulting company. 
One document to which you might contribute is a report to the city planning 
board about how building a housing development would affect the natural 
environment as well as the city’s roads, schools, and sanitation infrastructure. 
That’s the subject of the report. The purpose is to motivate the planning board 
to approve the project so that it can begin. How does the audience affect how 
you analyze your purpose? You think about who the board members are. If 
most of them are not engineers, you don’t want to use specialized vocabulary 
and advanced engineering graphics and concepts. You don’t want to dwell on 
the technical details. Rather, you want to use general vocabulary, graphics, and 
concepts. You want to focus on the issues the board members are concerned 
about. Would the development affect the environment negatively? If so, is the 
developer including a plan to offset that negative effect? Can the roads handle 
the extra traffic? Can the schools handle the extra kids? Will the city have to 
expand its police force? Its fire department? Its sewer system? 

In other words, when you write to the planning board, you focus on topics 
they are most interested in, and you write the document so that it is easy 
for them to read and understand. If the project is approved and you need to 
communicate with other audiences, such as architects and contractors, you 
will have different purposes, and you will adjust your writing to meet each 
audience’s needs. 

What can go wrong when you don’t analyze your audience? McDonald’s 
Corporation found out when it printed takeout bags decorated with flags 
from around the world. Among them was the flag of Saudi Arabia, which 
contains scripture from the Koran. This was extremely offensive to Muslims, 
who consider it sacrilegious to throw out items bearing sacred scripture. As a 
result, McDonald’s lost public credibility. 

Throughout this chapter, the text will refer to your reader and your docu- 
ment. But all of the information refers as well to oral presentations, which are 
the subject of Chapter 21, as well as to nonprint documents, such as podcasts 
or videos. 


Using an Audience Profile Sheet 

As you read the discussions in this chapter about audience characteristics 
and techniques for learning about your audience, you might think about 
using an audience profile sheet: a form that prompts you to consider various 
audience characteristics as you plan your document. For example, the profile 
sheet can help you realize that you do not know much about your primary 
reader’s work history and what that history can tell you about how to shape 
your document. Figure 5.2 shows an audience profile sheet that provides 
important information about one of a writer’s most important readers. 
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FIGURE 5.2 

An Audience 
Profile Sheet 
Assume that you work in the draft- 
ing department of an architectural 
engineering firm. You know that 
the company's computer-assisted 
design (CAD) software is out of date 
and that recent CAD technology 
would make it easier and faster 
for the draftspeople to do their 
work. You want to persuade your 
company to authorize buying a 
CAD workstation that costs about 
$4,000. To do so, you fill out an audi- 
ence profile sheet for your primary 
reader, Harry Becker, the manager 
of your company's Drafting and 
Design Department. 


. You should modify this form to 
; meet your own needs and 
those of your organization. Fora 
downloadable version of Fig. 5.2, go 
to Ch. 5 > Additional Resources > 
Downloadable Forms: 
macmillanhighered.com 
/iaunchpad/techcommlle. 


AUDIENCE PROFILE SHEET 

Reader's Name: Harry Becker 

Reader's Job Title: Manager, Drafting and Design Department 
Kind of Reader: Primary X Secondary 

Education: BS, Architectural Engineering, Northwestern, 1992. CAD/CAM Short 
Course, 1 992; Motivating Your Employees Seminar, 1997; Writing on the Job 
Short Course, 2002 

Professional Experience: Worked for two years in a small architecture firm. 
Started here 1 6 years ago as a draftsperson. Worked his way up to Assistant 
Manager, then Manager. Instrumental in the Wilson project, particularly in 
coordinating personnel and equipment. 

Job Responsibilities: Supervises a staff of 1 2 draftspeople. Approves or denies 
all requests for capital expenditures over $2,000 coming from his department. 
Works with employees to help them make the best case for the purchase. After 
approving or denying the request, forwards it to Tina Buterbaugh, Manager, 
Finance Dept., who maintains all capital expenditure records. 

Personal Characteristics: N/A 

Personal Preferences: Likes straightforward documents, lots of evidence, clear 
structure. Dislikes complicated documents full of jargon. 

Cultural Characteristics: Nothing of note. 

Attitude Toward the Writer: No problems. 

Attitude Toward the Subject: He understands and approves of my argument. 

Expectations About the Subject: Expects to see a clear argument with financial 
data and detailed comparisons of available systems. 

Expectations About the Document: Expects to see a report, with an executive 
summary, of about 1 0 pages. 

Reasons for Reading the Document: To offer suggestions and eventually 
approve or deny the request. 

Way of Reading the Document: 

Skim it Study it X Read a portion of it Which portion? 

Modify it and submit it to another reader 

Attempt to implement recommendations 

Use it to perform a task or carry out a procedure 

Use it to create another document 

Other Explain. 

Reading Skill: Excellent 
Reader's Physical Environment: N/A 
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If your document has several readers, you must decide whether to fill out 
only one sheet (for your most important reader) or several sheets. One tech- 
nique is to fill out sheets for one or two of your most important readers and 
one for each major category of other readers. For instance, you could fill out 
one sheet for your primary reader, Harry Becker; one for managers in other 
areas of your company; and one for readers from outside your company. 

When do you fill out an audience profile sheet? Although some writers like 
to do so at the start of the process as a way to prompt themselves to consider 
audience characteristics, others prefer to do so at the end of the process as a 
way to help themselves summarize what they have learned about their audi- 
ence. Of course, you can start to fill out the sheet before you begin and then 
complete it or revise it at the end. 


Determining the Important 
Characteristics of Your Audience 

When you analyze the members of your audience, you are trying to learn 
what you can about their technical background and knowledge, their reasons 
for reading or listening to you, their attitudes and expectations, and how they 
will use the information you provide. 

WHO ARE YOUR READERS? 

For each of your most important readers, consider six factors: 

• The reader's education. Think not only about the person’s degree but also 
about when the person earned the degree. A civil engineer who earned a 
BS in 1995 has a much different background than a person who earned the 
same degree in 2015. Also consider any formal education or training the 
person completed while on the job. 

Knowing your reader’s educational background helps you determine 
how much supporting material to provide, what level of vocabulary to 
use, what kind of sentence structure to use, what types of graphics to 
include, how long your document should be, and whether to provide such 
elements as a glossary or an executive summary. 

• The reader's professional experience. A nurse with a decade of experience 
might have represented her hospital on a community committee to 
encourage citizens to give blood and might have contributed to the 
planning for the hospital’s new delivery room. These experiences would 
have provided several areas of competence or expertise that you should 
consider as you plan your document. 

• The reader's job responsibility. Consider the major job responsibility of 
your reader and how your document will help that person accomplish it. 
For example, if you are writing a feasibility study on ways to cool the air 
for a new office building and you know that your reader, an upper-level 
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manager, oversees operating expenses, you should explain how you are 
estimating future utility costs. 

• The reader's personal characteristics. The reader’s age might suggest 
how he or she will read and interpret your document. Because a senior 
manager at age 60 might know less about a current technology than a 
30-year-old manager does, you might need to describe that technology 
in greater detail for the senior manager. Does your reader have any other 
personal characteristics, such as impaired vision, that affect the way you 
write and design your document? 

• The reader's personal preferences. One person might hate to see the first- 
person pronoun I in technical documents. Another might find the word 
interface distracting when the writer isn’t discussing computers. Does 
your reader prefer one type of application (such as blogs or memos) over 
another? Try to accommodate as many of your reader’s preferences as 
you can. 

• The reader's cultural characteristics. Understanding cultural characteristics 
can help you appeal to your reader’s interests and avoid confusing 

or offending him or her. As discussed later in this chapter (p. 95), 
cultural characteristics can affect virtually every aspect of a reader’s 
comprehension of a document and perception of the writer. 

WHY IS YOUR AUDIENCE READING YOUR DOCUMENT? 

For each of your most important readers, consider why he or she will read your 
document. Some writers find it helpful to classify readers into categories — 
such as primary, secondary, and tertiary — that identify each reader’s distance 
from the writer. Here are some common descriptions of these three categories 
of readers: 

• A primary audience consists of people to whom the communication is 
directed; they may be inside or outside the writer’s own organization. 

For example, they might include the writer’s team members, who 
assisted in carrying out an analysis of a new server configuration for 
the IT department; the writer’s supervisor, who reads the analysis to 
decide whether to authorize its main recommendation to adopt the new 
configuration; and an executive, who reads it to determine how high 

a priority the server project should have on a list of projects to fund. If 
you were producing text or videos for the Hewlett-Packard website, your 
primary audience would include customers, vendors, and suppliers who 
visit the site. 

• A secondary audience consists of people more distant from the writer who 
need to stay aware of developments in the organization but who will not 
directly act on or respond to the document. Examples include managers 
of other departments, who are not directly involved in the project but 
who need to be aware of its broad outlines, and representatives from the 
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marketing and legal departments, who need to check that the document 
conforms to the company’s standards and practices and with relevant 
legal standards, such as antidiscrimination or intellectual-property laws. 
External readers who are part of a secondary audience might include 
readers of your white paper who are not interested in buying your product 
but who need to stay current with the new products in the field. 

• A tertiary audience consists of people even further removed from the 
writer who might take an interest in the subject of the report. Examples 
include interest groups (such as environmental groups or other advocacy 
organizations); local, state, and federal government officials; and, if 

the report is made public, the general public. Even if the report is not 
intended to be distributed outside the organization, given today’s climate 
of information access and the ease with which documents can be 
distributed, chances are good that it will be made available to outsiders. 

Regardless of whether you classify your readers using a scheme such 
as this, think hard about why the most important audience members will 
read your document. Don’t be content to list only one purpose. Your direct 
supervisor, for example, might have several purposes that you want to keep 
in mind: 

• to learn what you have accomplished in the project 

• to determine whether to approve any recommendations you present 

• to determine whether to assign you to a follow-up team that will work on 
the next stage of the project 

• to determine how to evaluate your job performance next month 

You will use all of this information about your audience as you determine the 
ways it affects how you will write your document or plan your presentation. 
In the meantime, write the information down so that you can refer to 
it later. 

WHAT ARE YOUR READERS' ATTITUDES AND EXPECTATIONS? 

In thinking about the attitudes and expectations of each of your most impor- 
tant readers, consider these three factors: 

• Your reader's attitude toward you. Most people will like you because you 
are hardworking, intelligent, and cooperative. Some won’t. If a reader’s 
animosity toward you is irrational or unrelated to the current project, try 
to earn that person’s respect and trust by meeting him or her on some 
neutral ground, perhaps by discussing other, less volatile projects or some 
shared interest, such as gardening, skiing, or science-fiction novels. 

• Your reader's attitude toward the subject. If possible, discuss the subject 
thoroughly with your primary readers to determine whether they are 
positive, neutral, or negative toward it. Here are some basic strategies for 
responding to different attitudes. 
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For tips on critiquing a team 
member's draft diplomatically, see 
Ch. 4, p. 68. 


IF . . . 

TRY THIS... 

Your reader is neutral or 
positively inclined toward 
your subject 

Write the document so that it responds to the reader's 
needs; make sure that vocabulary, level of detail, 
organization, and style are appropriate. 


Your reader is hostile to • Find out what the objections are, and then answer them 
the subject or to your directly. Explain why the objections are not valid or are 

approach to it less important than the benefits. For example, you want 

to hire an online-community manager to coordinate 
your company's social-media efforts, but you know 
that one of your primary readers won't like this idea. 

Try to find out why. Does this person think social media 
are a fad? That they are irrelevant and can't help your 
company? If you understand the objections, you can 
explain your position more effectively. 

• Organize the document so that your recommendation 
follows your explanation of the benefits. This strategy 
encourages the hostile reader to understand your 
argument rather than to reject it out of hand. 

• Avoid describing the subject as a dispute. Seek areas 
of agreement and concede points. Avoid trying to 
persuade readers overtly; people don't like to be 
persuaded, because it threatens their ego. Instead, 
suggest that there are new facts that need to be 
considered. People are more likely to change their 
minds when they realize this. 


Your reader was 
instrumental in creating 
the policy or procedure 
that you are arguing is 
ineffective 


In discussing the present system's shortcomings, be 
especially careful if you risk offending one of your readers. 
When you address such an audience, don't write, "The 
present system for logging customer orders is completely 
ineffective." Instead, write, "While the present system 
has worked well for many years, new developments in 
electronic processing of orders might enable us to improve 
logging speed and reduce errors substantially." 


• Your reader's expectations about the document. Think about how 
your readers expect to see the information treated in terms of scope, 
organizational pattern, and amount of detail. Consider, too, the 
application. If your reader expects to see the information presented as a 
memo, use a memo unless some other format would clearly work better. 

HOW WILL YOUR READERS USE YOUR DOCUMENT? 

In thinking about how your reader will use your document, consider the fol- 
lowing four factors: 

• The way your reader will read your document. Will he or she 

— file it? 

— skim it? 
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— read only a portion of it? 

— study it carefully? 

— modify it and submit it to another reader? 

— try to implement its recommendations? 

— use it to perform a test or carry out a procedure? 

— use it as a source document for another document? 

If only 1 of your 15 readers will study the document for details such as 
specifications, you don’t want the other 14 people to have to wade through 
them. Therefore, put this information in an appendix. If you know that 
your reader wants to use your status report as raw material for a report 
to a higher-level reader, try to write it so that it can be reused with little 
rewriting. Use the reader’s own writing style and make sure the reader has 
access to the electronic file so that passages can be merged into the new 
document without needing to be retyped. 

• Your reader's reading skill. Consider whether you should be writing at all 
or whether it would be better to use another medium, such as a video, an 
oral presentation, or a podcast. If you decide to write, consider whether 
your reader can understand how to use the type of document you have 
selected, handle the level of detail you will present, and understand your 
graphics, sentence structure, and vocabulary. 

• The physical environment in which your reader will read your document. 

Often, technical documents are formatted in a special way or constructed 
of special materials to improve their effectiveness. Documents used 
in poorly lit places might be printed in larger-than-normal type. If 
documents are to be used on ships, on aircraft, or in garages, where they 
might be exposed to wind, water, and grease, you might have to use 
special waterproof bindings, oil-resistant or laminated paper, color coding, 
and unusual-sized paper. 

• The digital environment in which your reader will read your document. 

If you are writing a document that will be viewed online, consider the 
platforms on which it will be accessed. Will readers be viewing it on 
mobile devices? Desktop computers? Both? How can you design the 
document so that it is easy to access — easy to get to, to see, to navigate, 
and to use — in these environments? 


Techniques for Learning About Your Audience 

To learn about your audience, you figure out what you do and do not already 
know, interview people, read about them, and read documents they have 
written. Of course, you cannot perform extensive research about every pos- 
sible reader of every document you write, but you should learn what you can 
about your most important readers of your most important documents. 


For more about designing a 
document for use in different 
environments, see Ch. 1 1, p. 254. 
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For a discussion of interviewing, see 
Ch. 6, p. 136. 


ANALYZING YOUR AUDIENCE AND PURPOSE 

DETERMINING WHAT YOU ALREADY 
KNOW ABOUT YOUR AUDIENCE 

Start by asking yourself what you already know about your most important 
readers: their demographics (such as age, education, and job responsibilities); 
their expectations and attitudes toward you and the subject; and the ways 
they will use your document. Then list the important factors you don’t know. 
That is where you will concentrate your energies. The audience profile sheet 
shown in Figure 5.2 (p. 86) can help you identify gaps in your knowledge 
about your readers. 

INTERVIEWING PEOPLE 

For your most important readers, make a list of people who you think have 
known them and their work the longest or who are closest to them on the 
job. These people might include those who joined the organization at about 
the same time your readers did; people who work in the same department as 
your readers; and people at other organizations who have collaborated with 
your readers. 

Prepare a few interview questions that are likely to elicit information 
about your readers and their preferences and needs. For instance, you are 
writing a proposal for a new project at work. You want to present return-on- 
investment calculations to show how long it will take the company to recoup 
what it invested, but you’re not sure how much detail to present because you 
don’t know whether an important primary reader has a background in this 
aspect of accounting. Several of this reader’s colleagues will know. Interview 
them in person, on the phone, or by email. 

READING ABOUT YOUR AUDIENCE ONLINE 

If you are writing for people in your own organization, start your research 
there. If your primary reader is a high-level manager or executive, search the 
organization’s website or internal social network. Sections such as “About 
Us,” “About the Company,” and “Information for Investors” often contain a 
wealth of biographical information, as well as links to other sources. 

In addition, use a search engine to look for information on the Internet. 
You are likely to find newspaper and magazine articles, industry directories, 
websites, and blog posts about your audience. 

SEARCHING SOCIAL MEDIA FOR 
DOCUMENTS YOUR AUDIENCE HAS WRITTEN 

Documents your readers have written can tell you a lot about what they like 
to see with respect to design, level of detail, organization and development, 
style, and vocabulary. If your primary audience consists of those within your 
organization, start searching for documents they’ve produced within the 
company. Then broaden the search to the Internet. 

Although some of your readers might have written books or articles, many 
or even most of them might be active users of social media, such as Face- 
book. Pay particular attention to Linkedln, a networking site for profession- 
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Mike Markley 

Managing Director at Aquent; Experienced Professional 
Services Manager; Technical Communication 
Professional 

Boise, Idaho Area | Writing and Editing 

Current Aquent Boise State University 

Previous Leadership 8oise | Boise Metro Chamber of Commerce. 

Sakson & Taylor. Inc., Lionbridge Technologies. Inc. 

Education Boise State University 


1st 


Send a message 


03 wv/w.Snkedin.conVin/mjkemarWey 


500+ 

connections 


M Contact info 


FIGURE 5.3 ALinkedlnBio 

Source: Markley, 2013: www.linkedin.com/profile/view?id=588443&locale=en_US&trk=tyah. Reprinted by permission of Mike 
Markley. 


This summary is followed by a much 
more detailed description of Mike 
Markley's professional history and 
education. Even this brief summary 
suggests that Markley has extensive 
experience (note the title Managing 
Director). 


als. Linkedln profiles are particularly useful because they include a person’s 
current and former positions and education, as well as recommendations 
from other professionals. Figure 5.3 is an excerpt from the Linkedln entry 
written by Mike Markley, a technical communicator at Aquent. 

Markley begins his Linkedln biography with these paragraphs: 

Mike Markley serves as Managing Director for Aquent Studios, a professional 
services firm, and manages a team of technical communicators, designers, project 
managers, and account managers throughout the United States and India. Prior to 
joining Aquent, he worked at Micron Technology and Lionbridge in multiple content 
development and management roles. 

Mike holds a Bachelor of Science degree in Communication from University of Idaho 
and a Master of Arts in Technical Communication from Boise State University, where 
he currently serves as an adjunct instructor of technical communication. 

These two paragraphs suggest a couple of points about Markley’s credentials: 

• He has an extensive background, not only in writing and editing but also 
in various levels of management. You can expect that he knows project 
management, budgeting, and human resources. He understands both how 
to make documents and how to lead teams that make documents. 

• He has experience overseeing project teams in India. This experience gives 
him a broad perspective not only on how two very different cultures see 
the world but also on how to supervise people from other cultures so that 
they work effectively and efficiently. 

In short, when you read Markley’s comments on Linkedln, you get the clear 
impression that he is an experienced, versatile, and highly respected techni- 
cal communicator. 
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The excerpt from Mike Markley's 
tweet history shows a variety 
of types of posts: a tweet about 
a news item, another about his 
company's upcoming webinar, and 
a job ad. Also in Markley's history 
are thank-you tweets to speakers at 
conferences, as well as occasional 
personal tweets, such as the one 
urging his followers to donate to 
public radio and one celebrating a 
Boise State football win. 


Mike Markley gmmboise iDecll 

Tech Firm Implements Employee 'Zero Email’ Policy - Yahoo! News 
news.yahoo.com/tech-firm-impl... via @YahooNews 
D Viewsummaiy 



Mike Markley @mmboise 11 Oct 11 

AMA|@Aquent Webcast Flexible Workforce Strategies to Improve 
Your Marketing Team's Effectiveness Wed Oct 12 Noon ET bit.ly 
/qS7xgv 

Expand 


Mike Markley gmmboise 16 Sep 11 

Aquent Studios is recruiting information developers in #Boise. bit.ly 
/pY9gAZ 

Expand 


FIGURE 5.4 Excerpt from a List of Tweets 

Source: Markley, 2013: http://twitter.com/mmboise. Reprinted by permission of Mike Markley. 


A typical Linkedln entry directs you to a person’s websites and blogs and 
to the Linkedln groups to which the person belongs. You can also see the 
person’s connections (his or her personal network). And if you are a Linkedln 
member, you can see whether you and the person share any connections. 

In addition, the person you are researching might have a social-media 
account on which he or she posts about matters related to his or her job. 
Reading a person’s recent posts will give you a good idea of his or her job 
responsibilities and professionalism, as shown in Figure 5.4. 

ANALYZING SOCIAL-MEDIA DATA 

Private companies and public agencies alike analyze social media to better 
understand their audiences. Private companies use these data primarily to 
determine who their customers are, how they feel about various marketing 
messages, and how these messages influence their buying behavior. Public 
agencies use these data to help them refine their own messages. 

For instance, the Centers for Disease Control and Prevention (CDC), a U.S. 
federal agency, analyzes social media to improve the quality and effective- 
ness of its public health information. The agency starts by classifying people 
into various categories by age (such as tweens, teens, baby boomers) and 
determining which media each group uses most. On the basis of these data, 
the agency designs and implements health campaigns on such topics as 
cancer screening, HIV/ AIDS prevention and treatment, vaccines, and smok- 
ing cessation. 
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Then the CDC monitors social media to determine how many people are 
seeing the agency’s information, how they are engaging with the informa- 
tion (whether they share the information or follow links to other sites), and 
whether the information is changing their behavior (Centers for Disease Con- 
trol, 2013). Among the data the CDC analyzes each month are the following: 

• the number of visitors to each of the CDC web pages 

• the most popular keywords searched on CDC pages as well as on selected 
other sites and popular search engines such as Google 

• the numbers of Facebook fans and TWitter followers 

• the number of click-throughs to CDC web pages from Facebook and Twitter 

On the basis of these data, the CDC adjusts its social-media campaigns to use 
its campaign resources most effectively. 


Communicating Across Cultures 

Our society and our workforce are becoming increasingly diverse, both 
culturally and linguistically, and businesses are exporting more goods and 
services. As a result, professionals often communicate with individuals from 
different cultural backgrounds, many of whom are nonnative speakers of 
English, both in the United States and abroad, and with speakers of other 
languages who read texts translated from English into their own languages. 

The economy of the United States depends on international trade. In 2010, 
according to the U.S. Census Bureau, the United States exported over $2.5 
trillion of goods and services (U.S. Census Bureau, 2012, p. 792). In that year, 
direct investment abroad by U.S. companies totaled more than $4.4 trillion 
(p. 796). In addition, the population of the United States itself is truly multi- 
cultural. Each year, the United States admits more than a million immigrants 
(p. 46). In 2010, 12.5 percent of the U.S. population was foreign born; of those 
foreign born, almost a third had entered the country since 2000 (p. 43). 

Effective communication requires an understanding of culture: the beliefs, 
attitudes, and values that motivate people’s behavior. 

UNDERSTANDING THE CULTURAL 
VARIABLES "ON THE SURFACE" 

Communicating effectively with people from another culture requires under- 
standing a number of cultural variables that lie on the surface. You need to 
know, first, what language or languages to use. You also need to be aware of 
political, social, religious, and economic factors that can affect how readers 
will interpret your documents. Understanding these factors is not an exact 
science, but it does require that you learn as much as you can about the cul- 
ture of those you are addressing. 

A brief example: an American manufacturer of deodorant launched an 
advertising campaign in Japan in which a cute octopus applied the firm’s 
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product under each of its eight arms. But the campaign failed because, in 
Japan, an octopus is viewed as having eight legs, not eight arms (Bathon, 
1999). 

In International Technical Communication, Nancy L. Hoft (1995) describes 
seven major categories of cultural variables that lie on the surface: 

• Political. This category relates to trade issues and legal issues (for example, 
some countries forbid imports of certain foods or chemicals) and laws 
about intellectual property, product safety, and liability. 

• Economic. A country’s level of economic development is a critical factor. 

In many developing countries, most people cannot afford devices for 
accessing the Internet. 

• Social. This category covers many issues, including gender and business 
customs. In most Western cultures, women play a much greater role in 
the workplace than they do in many Middle Eastern and Asian cultures. 
Business customs — including forms of greeting, business dress, and gift 
giving — vary from culture to culture. 

• Religious. Religious differences can affect diet, attitudes toward individual 
colors, styles of dress, holidays, and hours of business. 

• Educational. In the United States, 40 million people are only marginally 
literate. In other cultures, the rate can be much higher or much lower. In 
some cultures, classroom learning with a teacher is considered the most 
acceptable way to study; in others, people tend to study on their own. 

• Technological. If you sell high-tech products, you need to know whether 
your readers have the hardware, the software, and the technological 
infrastructure to use them. 

• Linguistic. In some countries, English is taught to all children starting in 
grade school; in other countries, English is seen as a threat to the national 
language. In many cultures, the orientation of text on a page and in a book 
is not from left to right. 

In addition to these basic differences, you need to understand dozens of 
other factors. For instance, the United States is the only major country that 
has not adopted the metric system. Whereas Americans use periods to sepa- 
rate whole numbers from decimals, and commas to separate thousands from 
hundreds, much of the rest of the world reverses this usage. 

UNITED STATES 3,425.6 

Europe 3.425,6 

Also, in the United States, the format for writing out and abbreviating dates 
is different from that of most other cultures: 

united states March 2, 201 5 3/2/1 5 

Europe 2 March 201 5 2/3/15 

201 5 March 2 15/3/2 


JAPAN 
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These cultural variables are important in obvious ways: for example, 
you can’t send a file to a person who doesn’t have access to the Internet. 
However, there is another set of cultural characteristics — those beneath the 
surface — that you also need to understand. 

UNDERSTANDING THE CULTURAL 
VARIABLES "BENEATH THE SURFACE" 

Scholars of multicultural communication have identified cultural variables 
that are less obvious than those discussed in the previous section but just as 
important. Writing scholars Elizabeth Tebeaux and Linda Driskill (1999) explain 
five key variables and how they are reflected in technical communication. 

• Focus on individuals or groups. Some cultures, especially in the West, value 
individuals more than groups. The typical Western employee doesn’t see 
his or her identity as being defined by the organization for which he or she 
works. Other cultures, particularly those in Asia, value groups more than 
individuals. The typical employee in such cultures sees himself or herself 
more as a representative of the organization than as an individual who 
happens to work there. 

Communication in individualistic cultures focuses on the writer’s and 
reader’s needs rather than on those of their organizations. Writers use the 
pronoun I rather than we. Letters are addressed to the principal reader and 
signed by the writer. 

Communication in group-oriented cultures focuses on the 
organization’s needs by emphasizing the benefits to be gained through a 
cooperative relationship between organizations. Writers emphasize the 
relationship between the writer and the reader rather than the specific 
technical details of the message. Writers use we rather than I. They might 
address letters to “Dear Sir” and use their organization’s name, not their 
own, in the complimentary close. 

• Distance between business life and private life. In some cultures, especially in 
the West, many people separate their business lives from their private lives. 
When the workday ends, they are free to go home and spend their time as 
they wish. In other cultures, particularly in Asia, people see a much smaller 
distance between their business lives and their private lives. Even after the 
day ends, they still see themselves as employees of their organization. 

Cultures that value individualism tend to see a great distance between 
business and personal lives. In these cultures, communication focuses on 
technical details, with relatively little reference to personal information 
about the writer or the reader. 

Cultures that are group oriented tend to see a smaller distance between 
business life and private life. In these cultures, communication contains 
much more personal information — about the reader’s family and health — 
and more information about general topics — for example, the weather 
and the seasons. The goal is to build a formal relationship between the 



98 


5 


ANALYZING YOUR AUDIENCE AND PURPOSE 


two organizations. Both the writer and the reader are, in effect, on call 
after business hours and are likely to transact business during long social 
activities such as elaborate dinners or golf games. 

• Distance between ranks. In some cultures, the distance in power and 
authority between workers within an organization is small. This small 
distance is reflected in a close working relationship between supervisors 
and their subordinates. In other cultures, the distance in power and 
authority between workers within an organization is great. Supervisors do 
not consult with their subordinates. Subordinates use formal names and 
titles — “Mr. Smith,” “Dr. Jones” — when addressing people of higher rank. 

Individualistic cultures that separate business and private lives tend to 
have a smaller distance between ranks. In these cultures, communication 
is generally less formal. Informal documents (emails and memos) are 
appropriate, and writers often sign their documents with their first names 
only. Keep in mind, however, that many people in these cultures resent 
inappropriate informality, such as letters or emails addressed “Dear Jim” 
when they have never met the writer. 

In cultures with a great distance between ranks, communication is 
generally formal. Writers tend to use their full professional titles and to 
prefer formal documents (such as letters) to informal ones (such as memos 
and emails). Writers make sure their documents are addressed to the 
appropriate person and contain the formal design elements (such as title 
pages and letters of transmittal) that signal their respect for their readers. 

• Need for details to be spelled out. Some cultures value full, complete 
communication. The written text must be comprehensive, containing all 
the information a reader needs to understand it. These cultures are called 
low-context cultures. Other cultures value documents in which some of the 
details are merely implied. This implicit information is communicated 
through other forms of communication that draw on the personal 
relationship between the reader and the writer, as well as social and 
business norms of the culture. These cultures are called high-context cultures. 

Low-context cultures tend to be individualistic; high-context cultures 
tend to be group oriented. In low-context cultures, writers spell out all 
the details. Documents are like contracts in that they explain procedures 
in great detail and provide specific information that indicates the rights 
and responsibilities of both the writer and the readers. In high-context 
cultures, writers tend to omit information that they consider obvious 
because they don’t want to insult the reader. For example, a manual 
written for people in a high-context culture might not explain why a cell- 
phone battery needs to be charged because everyone already knows why. 

• Attitudes toward uncertainty. In some cultures, people are comfortable 
with uncertainty. They communicate less formally and rely less 

on written policies. In many cases, they rely more on a clear set of 
guiding principles, as communicated in a code of conduct or a mission 
statement. In other cultures, people are uncomfortable with uncertainty. 
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Businesses are structured formally, and they use written procedures for 
communicating. 

In cultures that tolerate uncertainty, written communication tends 
to be less detailed. Oral communication is used to convey more of the 
information that is vital to the relationship between the writer and the 
readers. In cultures that value certainty, communication tends to be 
detailed. Policies are lengthy and specific, and forms are used extensively. 
Roles are firmly defined, and there is a wide distance between ranks. 

As you consider this set of cultural variables, keep four points in mind: 

• Each variable represents a spectrum of attitudes. Terms such as high-context 
and Iou;-context, for instance, represent the opposite end points on a scale. 
Most cultures occupy a middle ground. 

• The variables do not line up in a clear pattern. Although the variables 
sometimes correlate — for example, low-context cultures tend to be 
individualistic — in any one culture, the variables do not form a consistent 
pattern. For example, the dominant culture in the United States is highly 
individualistic rather than group oriented but only about midway along 
the scale in terms of tolerance of uncertainty. 

• Different organizations within the same culture can vary greatly. For 

example, one software company in Germany might have a management 
style that does not tolerate uncertainty, whereas another software 
company in that country might tolerate a lot of uncertainty. 

• An organization's cultural attitudes are fluid, not static. How an organization 
operates is determined not only by the dominant culture but also by its 
own people. As new people join an organization, its culture changes. The 
IBM of 1995 is not the IBM of 2015. 

For you as a communicator, this set of variables therefore offers no 
answers. Instead, it offers a set of questions. You cannot know in advance 
the attitudes of the people in an organization. You have to interact with them 
for a long time before you can reach even tentative conclusions. The value of 
being aware of the variables is that they can help you study the communica- 
tion from people in that organization and become more aware of underlying 
values that affect how they will interpret your documents. 

CONSIDERING CULTURAL VARIABLES AS YOU WRITE 

The challenge of communicating effectively with a person from another cul- 
ture is that you are communicating with a person, not a culture. You cannot 
be sure which cultures have influenced that person (Lovitt, 1999). For exam- 
ple, a 50-year-old Japanese-born manager at the computer manufacturer 
Fujitsu in Japan has been shaped by the Japanese culture, but he also has 
been influenced by the culture of his company and of the Japanese computer 
industry in general. Because he works on an export product, it is also likely 
that he has traveled extensively outside of Japan and has absorbed influ- 
ences from other cultures. 
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For books and other resources about 
writing to people from other cultures, 
see the Selected Bibliography, p. 693. 


A further complication is that when you communicate with a person from 
another culture, to that person you are from another culture, and you cannot 
know how much that person is trying to accommodate your cultural patterns. 

As writing scholar Arthur H. Bell (1992) points out, the communication between 
the two of you is carried out in a third, hybrid culture. When you write to a large 
audience, the complications increase. A group of managers at Fujitsu represents 
a far more complex mix of cultural influences than one manager at Fujitsu. 

No brief discussion of cultural variables can answer questions about how to 
write for a particular multicultural audience. You need to study your readers’ 
culture and, as you plan your document, seek assistance from someone native 
to the culture who can help you avoid blunders that might confuse or offend 
your readers. 

Start by reading some of the basic guides to communicating with people 
from other cultures, and then study guides to the particular culture you are 
investigating. In addition, numerous sites on the Internet provide useful 
guidelines that can help you write to people from another culture. If possible, 
study documents written by people in your audience. If you don’t have access 
to these, try to locate documents written in English by people from the cul- 
ture you are interested in. 

Figures 5.5 and 5.6 show excerpts from documents that provide useful 
glimpses into cultural variables. Figure 5.5 is part of a management-philosophy 
statement from a Japanese electronics company. Figure 5.6, from a training 
manual used by Indian Railways, describes a medical exam that prospective 
applicants are required to take. 


Notice how the writers describe 
the company philosophy in terms 
of ever-expanding circles: from 
employees to society to humankind. 
This philosophy attempts to relate 
a fulfilling workplace environment 
to the "pursuit of mental riches asa 
human being." 


The circle metaphor continues with 
the reference to how the company 
contributes to general welfare not 
only by creating "wonderful 
products" but also by paying taxes 
to support the society that enables 
the company to continue to 
flourish. This interdependence 
of the individual and society — 
and a balanced life of work and 
recreation — is deeply ingrained in 
many Asian cultures. 


The Management Rationale of the Kyocera Group is: "To provide 
opportunities for the material and intellectual growth of all our employees, 
and through our joint efforts, contribute to the advancement of society and 
humankind."The"material and intellectual growth" that we aim for includes 
the pursuit of economic stability, and entails the pursuit of mental riches as a 
human being, in the shape of life with purpose and job satisfaction through 
self-fulfillment in the workplace. 

Additionally, the steady refinement of our technology allows us to provide 
the world with wonderful products one after another, and thereby contribute 
to the advancement of science and technology. At the same time, by steadily 
raising profits as a company we aim to contribute to the improvement of 
common welfare, through increased tax payments and other means. The 
guidelines for action in pursuing the Management Rationale are set out in 
the Kyocera Philosophy. As a state of mind for leading wonderful lives, we are 
striving day by day to practice the Kyocera Philosophy. 



FIGURE 5.5 Statement of Management Philosophy by a Japanese Electronics 
Company 


Source: Kyocera Group, 2013: http://global.kyocera.com/ecology/philosophy.html. Used by permission of Kyocera Interna- 
tional. 
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501 . Introduction: (1 ) The standards of physical fitness to be adopted should 
make due allowance for the age and length of service, if any, of the candidate 
concerned. 

(2) No person will be deemed qualified for admission to the public service who 
shall not satisfy the Government, or the appointing authority, as the case may be, 
that he has no disease, constitutional affliction or bodily infirmity unfitting him, or 
likely to unfit him for that service. 

(3) It should be understood that the question of fitness involves the future as 
well as the present and that one of the main objectives of medical examination is 
to secure continuous effective service, and in the case of candidates for permanent 
appointment, to prevent early pension or payment in case of premature death. 


Note: The minimum height prescribed can be relaxed in case of candidates 
belonging to races such as Gorkhas, Garhwalis, Assamese, Nagaland tribal, whose 
average height is distinctly lower. 


FIGURE 5.6 Statement from an Indian Railways Training Manual 

Source: Indian Railways, 2000: http://www.indianrailways.gov.in/railwayboard/uploads/codesmanual/MMVol-l/Chapter5.pdf. 


A 


GUIDELINES 


The passage sounds as if it was 
written a hundred years ago, full of 
complicated sentences and formal 
vocabulary. The writing style is 
closer to that of the British (who 
colonized India) than that of the 
United States. 

However, the explanation of why 
the exam is used is particularly can- 
did: to save the government from 
having to support employees who 
become ill and therefore cannot 
perform the tasks for which they 
were hired. 

The wording of this note, which fol- 
lows a table showing the minimum 
height requirements for male and 
female applicants, would likely 
be considered offensive in most 
cultures. In India, a culture made of 
many ethnic groups and with a rigid 
caste system, most readers would 
not be offended. 


Writing for Readers from Other Cultures 


The following eight suggestions will help you communicate more effectively with 
multicultural readers. 


► Limit your vocabulary. Every word should have only one meaning, as called for 
in Simplified English and in other basic-English languages. 

► Keep sentences short. There is no magic number, but try for an average sentence 
length of no more than 20 words. 

► Define abbreviations and acronyms in a glossary. Don't assume that your read- 
ers know what a GFI (ground fault interrupter) is, because the abbreviation is 
derived from English vocabulary and word order. 

► Avoid jargon unless you know your readers are familiar with it. For instance, 
your readers might not know what a graphical user interface is. 

► Avoid idioms and slang. These terms are culture specific. If you tell your Japa- 
nese readers that your company plans to put on a "full-court press," most likely 
they will be confused. 

► Use the active voice whenever possible. The active voice is easier for nonnative 
speakers of English to understand than the passive voice. 


For a discussion of Simplified English, 
seeCh. 10, p.242. 


For more about voice, see Ch. 1 0, 
p.231. 


► Be careful with graphics. The garbage-can icon on the Macintosh computer does For more about graphics, seeCh. 12, 

not translate well, because garbage cans might have different shapes and be p. 334. 

made of different materials in other countries. 


► Be sure someone from the target culture reviews your document. Even if you 
have had help in planning the document, have it reviewed before you publish 
and distribute it. 
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DOCUMENT ANALYSIS ACTIVITY 


Examining Cultural Variables in a Business Letter 


These two versions of the same 
business letter were written 
by a sales manager for an 
American computer company. 
The first letter was addressed 
to a potential customer in 
the United States; the second 
version was addressed to a 
potential customer in Japan. 
The questions in the margin ask 
you to think about how cultural 
variables affect the nature of 
the evidence, the structure of 
the letters, and their tone (see 
pp. 95-100). 


Server Solutions 
Cincinnati, OH 46539 

July 3, 2015 

Mr. Philip Henryson, Director of Purchasing 
Allied Manufacturing 
1321 Industrial Boulevard 
Boise, ID 83756 

^ Dear Mr. Henryson: 

Thank you for your inquiry about our PowerServer servers. I'm happy to answer 
your questions. 

The most popular configuration is our PowerServer 3000. This model is based on 
the Intel® Xeon ES-4600 processor, ServerSure High-End UltraLite chipset with 
quadpeer PCI architecture, and embedded RAID. The system comes with our 
Installlt system-management CD, which lets you install the server and monitor 
and manage your network with a simple graphical interface. With six PCI slots, 
the PowerServer 3000 is equipped with redundant cooling as well as redundant 
power, and storage expandability to 1 .0TB. I'm taking the liberty of enclosing the 
brochure for this system to fill you in on the technical details. 

The PowerServer 3000 has performed extremely well on a number of industry 
benchmark tests. I'm including with this letter copies of feature articles on the 
system from PC World, CIO, and DigITimes. 

It would be a pleasure for me to arrange for an on-site demo at your convenience. 
I will phone you on Monday to see what dates would be best for you. In the 
meantime, please do not hesitate to get in touch with me directly if you have any 
questions about the PowerServer line. 

I look forward to talking with you next week. 

Sincerely, 

WoAvm. f'^wr 

Nadine Meyer 
Director of Marketing 

Attachments: 

"PowerServer 3000 Facts at a Glance" 

"Another Winner from Server Solutions" 

"Mid-Range Servers for 201 5" 

"Four New Dual-Processor Workhorses" 


Nadine Meyer 
Director of Marketing 


( continued ) 
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Examining Cultural Variables in a Business Letter ( continued ) 


Server Solutions 
Cincinnati, OH 46539 


Mr. Kato Kirisawa, Director of Purchasing Nadine Meyer 

Allied Manufacturing Director of Marketing 

3-7-32 Kita Urawa 

Saitama City, Saitama Pref. 336-0002 
Japan 

Q Dear Sir: 


© 


It is my sincere hope that you and your loved ones are healthy and enjoying 
the pleasures of summer. Here in the American Midwest, the warm rays of the 
summer sun are accompanied by the sounds of happy children playing in the 
neighborhood swimming pools. I trust that the same pleasant sounds greet you 
in Saitama City. 


Your inquiry about our PowerServer 3000 suggests that your company is 
growing. Allied Manufacturing has earned a reputation in Japan and all of Asia 
for a wide range of products manufactured to the most demanding standards of 
quality. We are not surprised that your company requires new servers that can be 
expanded to provide fast service for more and more clients. 


For more than 20 years, Server Solutions has had the great honor of 
manufacturing the finest computer servers to meet the needs of our valued 
O customers all over the world. We use only the finest materials and most 

innovative techniques to ensure that our customers receive the highest-quality, 
uninterrupted service that they have come to expect from us. 


0 


One of my great pleasures is to talk with esteemed representatives such as 
yourself about how Server Solutions can help them meet their needs for the 
most advanced servers. I would be most gratified if our two companies could 
enter into an agreement that would be of mutual benefit. 


Sincerely, 

Wcwlw f^wr 

Nadine Meyer 
Director of Marketing 


Attachments: 

"PowerServer 3000 Facts at a Glance" 
"Another Winner from Server Solutions" 
"Mid-Range Servers for 2015" 

"Four New Dual-Processor Workhorses" 


1. How does the difference 
in the salutations (the 
"Dear . . ."part of the letter) 
reflect a cultural difference? 

2 . Does the first paragraph of 
the second letter have any 
function beyond delaying 
the discussion of business? 

3 . What is the point of telling 
Mr. Kirisawa about his own 
company? How does this 
paragraph help the writer 
introduce her own com- 
pany's products? 

4 . To a reader from the United 
States, the third paragraph 
of the second letter would 
probably seem thin. What 
aspect of Japanese culture 
makes it effective in the 
context of this letter? 

5 . Why doesn't the writer make 
a more explicit sales pitch at 
the end of the second letter? 


2015 July3 
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For more about design for 
multicultural readers, seeCh. 11, 
p. 286. For more about graphics for 
international readers, seeCh. 12, 
p. 334. 


USING GRAPHICS AND DESIGN FOR 
MULTICULTURAL READERS 

One of the challenges of writing to people from another culture is that 
they are likely to be nonnative speakers of English. One way to overcome 
the language barrier is to use effective graphics and appropriate document 
design. 

However, the most appropriate graphics and design can differ from culture 
to culture. Business letters written in Australia use a different size paper and 
a different format than those in the United States. An icon for a file folder 
in a software program created in the United States could confuse European 
readers, who use file folders of a different size and shape (Bosley, 1999). 

A series of graphics arranged left to right could confuse readers from the 
Middle East, who read from right to left. For this reason, you should study 
samples of documents written by people from the culture you are addressing 
to learn the important differences. 


Applying What You Have 
Learned About Your Audience 

You want to use what you know about your audience to tailor your commu- 
nication to their needs and preferences. Obviously, if your most important 
reader does not understand the details of DRAM technology, you cannot use 
the concepts, vocabulary, and types of graphics used in that field. If she uses 
one-page summaries at the beginning of her documents, decide whether 
they will work for your document. If your primary reader’s paragraphs always 
start with clear topic sentences, yours should, too. 

The samples of technical communication shown in Figure 5.7 illustrate 
some of the ways writers have applied what they know about their audiences 
in text and graphics. 


ETHICS NOTE 


MEETING YOUR READERS' NEEDS RESPONSIBLY 

A major theme of this chapter is that effective technical communication meets your readers' 
needs. What this theme means is that as you plan, draft, revise, and edit, you should always be 
thinking of who your readers are, why they will read your document, and how they will read 
the document. For example, if your readers include many nonnative speakers of English, you 
will adjust your vocabulary, sentence structure, and other textual elements so that readers can 
understand your document easily. If your readers will be accessing the document on a mobile 
device, you will ensure that the design is optimized for their screen 

Meeting your readers' needs does not mean writing a misleading or inaccurate document. If 
your readers want you to slant the information, omit crucial data, or downplay bad news, they 
are asking you to act unethically. You should not do so. For more information on ethics, see 
Chapter 2. 
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What is XSLT? 

XSL Transformations (XSLT 2.0) is a language for transforming XML documents into other XML documents, text 
documents or HTML documents. You might want to format a chapter of a book using XSL-FO, or you might want to 
take a database query and format It as HTML. 

With XSLT 2.0. processors can operate not only on XML but on anything that can be made to look like XML: 
relational database tables, geographical information systems, file systems, anything from which your XSLT 
processor can build an XDM instance. In some cases an XSLT 2.0 processor might also be able to work directly 
from a database of XDM instances. This ability to operate on multiple input files in multiple formats, and to treat 
them all as if they were XML files, is very powerful. It is shared with XQuery, and with anything else using XPath 2.0: 



model 


a. Document presenting technical information to an expert audience 

Source: World Wide Web Consortium, 2013: http://www.w3.org/standards/xml/transformation.html. Reprinted by permission 
of WC3. 



b. Document motivating decision makers to learn about a product 

Source : TASER International, 2013: www.taser.com/products/on-officer-video/axon-flex-on-officer-video. Reprinted by permis- 
sion of TASER International, Inc. 

FIGURE 5.7 Using Text and Graphics to Appeal to Readers' Needs and Interests 


This excerpt from a technical 
description of a web coding 
language appears on the site of the 
World Wide Web Consortium (W3C). 

Because the readers are coding 
experts, the writers use highly 
technical language and refer to 
advanced topics. Note, however, 
that the nontechnical information is 
written simply and directly. 

Notice that the graphic is based 
on a simple flowchart and basic 
icons. Why? Because the readers are 
interested only in understanding 
the logic of the process illustrated 
in the flowchart. 


This passage, from TASER, describes 
a videocam to be worn by police 
officers. It is addressed to high-level 
officers responsible for ordering 
equipment. 

The writer makes a simple 
argument: that an unbiased 
study showed how the product 
eliminated complaints by providing 
a video record of an incident. (The 
web page also includes text and a 
video highlighting the argument 
about the product.) 

The argument consists of two ele- 
ments: the photograph and the brief 
text. The photograph shows that 
the device is easy to wear. The text 
makes two points: (1 ) video of the 
incident will be even more compel- 
ling than an officer's court testimony, 
and (2) therefore the product can 
greatly reduce the number of 
incidents in which officers are disci- 
plined. Together, these points appeal 
to the interests of police supervisors, 
who don't want their officers to be 
unfairly charged. The links at the top 
of the page encourage the audience to 
take action, either by learning how to 
try out the device or by buying it. 


( continued ) 
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This excerpt from the Stay Healthy 
section of the American Cancer 
Society website shows several tech- 
niques for providing information to 
a general audience. 

The page begins with a short video 
and brief text intended to motivate 
readers to find out more about how 
to stay healthy. The tone through- 
out — from the words to the images 
of the smiling man and woman — is 
encouraging: it says, "You can do this." 

The page includes a set of seven 
links to detailed information on 
more-specific topics about preventing 
cancer. 

The Tools and Calculators section 
gives readers opportunities to learn 
more about how to improve their 
health. This section is consistent with 
the main point of this page: you can 
take steps to improve your health. 

Notice that the writers use 
simple, direct language, as well 
as the second person ("you”), to 
maintain an informal tone. 


Hewlett-Packard, one of the world's 
most innovative technology compa- 
nies, recently lost much of its luster 
because of management miscalcula- 
tions and scandals. This page from 
the HP site is part of the company's 
attempt to project a new, positive 
message. 

The smiling faces of company 
president and CEO Meg Whitman 
and of the other people suggest 
that bad times are over. 

In the quotation, the CEO is 
forthright about the company's mis- 
takes but asserts that the company 
has the people and resources neces- 
sary to "turn HP around." Note that 
five sentences in a row begin with 
"we," thereby including customers 
in the HP story. 

Whitman uses simple, strong 
words and sentences to project 
honesty and determination. And 
she signs her name"Meg."The point 
is that she is like HP's customers: 
hard working and down-to-earth. 



Stay Healthy 


Home 


Leam About Cancer 


Stay Healthy 


Watch: Introduction Video 


Find Support & Treatment Explore Research 


More than half of all cancer-deaths could be prevented by making healthy choices 
like not smoking, staym^at a healthy weight, eating nght, keeping active, and 
getting recommended screening tests in this section you can leam how to help 
lower^yedrchances of getting cancer, plus what screening tests the Amencan 
-^ncer Society recommends, and when 


Stay Healthy Topics 

Stay Away from Tobacco 
Eat Healthy and Get Active 
Be Sale in the Sun 
Other Ways to Protect Yourself 


Tools and Calculators 
These quizzes, calculators, reminders and 
other tools can help you make healthy 
choices, lower your risk for different cancers, 
or find it early. 


Find Cancer Early 

ACS Programs to Help You Stay Well 
Information for Health Care Professionals 


Smoking Quiz 

BMI Calculator 

Calorie Counter 

Nutrition and Activity Quiz 

Sun Safety Quiz 

Target Heart Rate Calculator 


c. Document presenting educational resources to a general audience 

Source: American Cancer Society, 2013: http://www.cancer.org/healthy/index. Reprinted by permission of the American 
Cancer Society. 




About HP 


Newsroom 
Investor Relations 
Jobs 

Global Citizenship 
Events 
Leadership 
HP Labs 
HP History 
Contact Us 


M 

Meg Whitman, 

HP President and CEO 


"Success hinges on consistency of leadership, 
focus, execution, and most importantly, great 
products and services. 


We are in a multi-year journey to turn HP around, and we have put in place a plan to restore HP to growth. 
We know where we need to go, and we're making progress. 


We continue to drive product innovation in our core markets, with a focus on cloud, security, and big data. 


We see big opportunities ahead, and we are well positioned to take advantage of these opportunities with 
our remarkable set of assets and strengths. We have the people, the plan, and the foundation in place to 
help us succeed on the next phase of the journey." 


d. Document reinforcing a brand 

Source: Hewlett-Packard, 2013: http://www8.hp.com/us/en/hp-information/index.htmi. Courtesy of Hewlett-Packard. 


FIGURE 5.7 ( continued ) 
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Writing for Multiple Audiences 

Many documents of more than a few pages are addressed to more than one 
reader. Often, an audience consists of people with widely different back- 
grounds, needs, and attitudes. 

If you think your document will have a number of readers, consider mak- 
ing it modular: break it up into components addressed to different readers. 

A modular report might contain an executive summary for managers who 
don’t have the time, knowledge, or desire to read the whole report. It might 
also contain a full technical discussion for expert readers, an implementa- 
tion schedule for technicians, and a financial plan in an appendix for budget 
officers. Figure 5.8 shows the table of contents for a modular report. 


Contents 


Foreword 

V 

Preface 

vii 

Summary for Policymakers 

1 

Technical Summary 

19 

Historical Overview of Climate Change Science 

93 

2 Changes in Atmospheric Constituents and Radiative Forcing 

129 

3 Observations: Atmospheric Surface and Climate Change 


4 Observations: Changes in Snow, Ice and Frozen Ground 

337 

5 Observations: Ocean Climate Change and Sea Level 

385 

6 Palaeoclimate 

433 

7 Coupling Between Changes in the Climate System and Biogeochemistry 

8 Climate Models and Their Evaluation 

499 

9 Understanding and Attributing Climate Change 

663 

10 Global Climate Projections 

747 

Regional Climate Projections 

847 

Annex 1: Glossary 

941 

Annex II Contributors to the IPCC WGI Fourth Assessment Report 

955 

Annex III Reviewers of the IPCC WGI Fourth Assessment Report 

969 

Annex IV: Acronyms 

981 

Index 

989 


This table of contents shows the 
organization of a modular docu- 
ment. 

Few readers will want to read the 
whole document — it's almost 1 ,000 
pages long. 


Most readers will want to read the 
18-page summary for policymakers. 


Some readers will want to read 
selected sections of the technical 
summary or"annexes" (appendixes). 


FIGURE 5.8 

Table of Contents for a Modular Report 

From Solomon et al., Climate Change 2007: The Physical Science Basis. Working Group I Contribution to the Fourth Assessment 
Report of the Intergovernmental Panel on Climate Change, p. xix. Cambridge University Press. 
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Determining Your Purpose 

Once you have identified and analyzed your audience, it is time to examine 
your purpose. Ask yourself this: “What do I want this document to accom- 
plish?” When your readers have finished reading what you have written, 
what do you want them to fenou; or belieue? What do you want them to do? 
Your writing should help your readers understand a concept, adopt a particu- 
lar belief, or carry out a task. 

In defining your purpose, think of a verb that represents it. (Sometimes, 
of course, you have several purposes.) The following list presents verbs in 
two categories: those used to communicate information to your readers and 
those used to convince them to accept a particular point of view. 


Communicating verbs 

authorize 

define 

describe 

explain 

illustrate 

inform 

outline 

present 

review 

summarize 


Convincing verbs 

assess 

evaluate 

forecast 

propose 

recommend 

request 


This classification is not absolute. For example, review could in some cases 
be a convincing verb rather than a communicating verb: one writer’s review of a 
complicated situation might be very different from another’s. 

Here are a few examples of how you can use these verbs to clarify the pur- 
pose of your document (the verbs are italicized). 

• This wiki presents the draft of our policies on professional use of social 
media within the organization. 

• This letter authorizes the purchase of six new tablets for the Jenkintown 
facility. 

• This report recommends that we revise the website as soon as possible. 

Sometimes your real purpose differs from your expressed purpose. For 
instance, if you want to persuade your reader to lease a new computer 
system rather than purchase it, you might phrase the purpose this way: to 
explain the advantages of leasing over purchasing. As mentioned earlier, many 
readers don’t want to be persuade d but are willing to learn new facts or ideas. 

In situations like this, stick to the facts. No matter how much you want to 
convince your readers, it is unacceptable to exaggerate or to omit important 
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information. Trust that the strength and accuracy of your writing will enable 
you to achieve your intended purpose. 

Gaining Management's Approval 

After you have analyzed your audience and purpose, consider gaining 
the approval of management before you proceed. The larger and more 
complex the project and the document, the more important it is to be 
sure that you are on the right track before you invest too much time and 
effort. 

For example, suppose you are planning a proposal to upgrade your com- 
pany’s computer-assisted-design (CAD) equipment. You already know your 
audience and purpose, and you are drafting a general outline in your mind. 
But before you actually start to write an outline or gather the information 
you will need, spend another 10 or 15 minutes making sure your primary 
reader, your supervisor, agrees with your thinking by submitting to him a 
brief description of your plans. You don’t want to waste days or even weeks 
working on a document that won’t fulfill its purpose. If you have misunder- 
stood what your supervisor wants, it is far easier to fix the problem at this 
early stage. 

Your description can also serve another purpose: if you want your reader’s 
views on which of two strategies to pursue, you can describe each one and 
ask your reader to state a preference. 

Choose an application that is acceptable to your reader, and then clearly 
and briefly state what you are trying to do in the project. Here is an example 
of the description you might submit to your boss about the CAD equipment. 
In composing this description of her plan, the writer drew on audience 
profile sheets for her two principal readers. She describes a logical, rational 
strategy for proposing the equipment purchase. 

Juan: 

Please tell me if you think this is a good approach for the proposal on CAD 
equipment. 

Outright purchase of the complete system will cost more than $1,000, so you would 
have to approve it and send it on for Tina's approval. (I'll provide leasing costs as well.) 

I want to show that our CAD hardware and software are badly out of date and need 
to be replaced. I'll be thorough in recommending new equipment, with independent 
evaluations in the literature, as well as product demonstrations. The proposal should 
specify what the current equipment is costing us and show how much we can save by 
buying the recommended system. 

I'll call you later today to get your reaction before I begin researching what's available. 
Renu 

Once you have received your primary reader’s approval, you can feel confi- 
dent about starting to gather information. 


The purpose of the memo 

A statement of the audience for the 
proposal 

A statement of the purpose, fol- 
lowed by early statements of the 
scope of the document 


A statement of how the writer 
intends to follow up on this memo 
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Revising Information for a New 
Audience and Purpose 

Chapter 2 introduced the concept of boilerplate information: standard text or 
graphics that are plugged into various documents published by your organi- 
zation (see p. 24). Often, however, when you write to a new audience or have 
a new purpose, you need to revise the information. 


FIGURE 5.9 Press 
Release 

From "Introducing Project Loon" 
Googleblog, June 1 4, 2013. Reprinted by 
permission of Google, Inc. 

A press release is a statement dis- 
tributed by a company to the news 
media to promote a new develop- 
ment at the company. The company 
hopes the news media will print the 
news release, thereby publicizing 
the development. 

The writer sketches in the technical 
problems. 


The writer then announces his belief 
that his company has solved the 
problem by looking at it from a new 
angle. His use of the word moonshot 
suggests that Google is proud of 
how ambitious the program is. 


The writer refers to previous 
attempts to use high-altitude 
platforms and explains why the new 
approach is different. 


INTRODUCING PROJECT LOON: BALLOON-POWERED INTERNET ACCESS 

The Internet is one of the most transformative technologies of our lifetimes. But for 2 
out of every 3 people on earth, a fast, affordable Internet connection is still out of reach. 
And this is far from being a solved problem. 

There are many terrestrial challenges to Internet connectivity — jungles, archipelagos, 
mountains 

Solving these problems isn't simply a question of time: it requires looking at the problem 
of access from new angles. So today we're unveiling our latest noonshc from Google: 
balloon-powered Internet access. 



We believe that it might actually be possible to build a ring of balloons, flying around 
the globe on the stratospheric winds, that provides Internet access to the earth below. 
It's very early days, but we've built a system that uses balloons, carried by the wind at 
altitudes twice as high as commercial planes, to beam Internet access to the ground 
at speeds similar to today's 3G networks or faster. As a result, we hope balloons could 
become an option for connecting rural, remote, and underserved areas, and for helping 
with communications after natural disasters. The idea may sound a bit crazy — and that's 
part of the reason we're calling it Project Loon — but there's solid science behind it. 

Balloons, with all their effortless elegance, present some challenges. Many projects 
have looked at high-altitude platforms to provide Internet access to fixed areas on the 
ground, but trying to stay in one place like this requires a system with major cost and 
complexity. So the idea we pursued was based on freeing the balloons and letting 


( continued ) 
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them sail freely on the winds. All we had to do was figure out how to control their path 
through the sky. We've now found a way to do that, using just wind and solar power: we 
can move the balloons up or down to catch the winds we want them to travel in 

Now we need some help — this experiment is going to take way more than our team 
alone. This week we started a pilot program in the Canterbury area of New Zealand 
with 50 testers trying to connect to our balloons. This is the first time we've launched 
this many balloons (30 this week, in fact) and tried to connect to this many receivers on 
the ground, and we're going to learn a lot that will help us improve our technology and 
balloon design 

This is still highly experimental technology and we have a long way to go — we'd love 
your support as we keep trying and keep flying! Follow our Gooqle+ page to keep up 
with Project Loon's progress. 

Onward and upward. 


GOOGLE'S LOON PROJECT PUTS BALLOON 
TECHNOLOGY IN SPOTLIGHT 

Google's Project Looi aims to bring remote parts of the globe online with a ring of 
floating balloons. The balloons will drift through the stratosphere — which is about 
twice as high as commercial planes fly — to deliver 3G service to off-the-grid areas. 

The ambitious project's recent test launch on New Zealand's South Island has 
generated a lot of media buzz, but it turns out that high-altitude platforms (HAP) have 
been around for a while. 

A decade ago, the European Union funded the CAPAHiNA project to deliver broadband 
from high-altitude platforms in the stratosphere. Back in 2005, it successfully produced 
broadband wireless access at distances of up to 37 miles (60 kilometers) from a free- 
floating balloon in the stratosphere over northern Sweden. 

m Tozt , an expert on wireless, satellite, and HAP communications at the University of 
York in Great Britain, was part of that effort. He spoke with National Geographic about 
the current state of the science — and the promising future beyond Google's balloons. 

Google's Loon Project has already been valuable in terms of getting people interested 
in what might be possible, says Tozer. "I'd be pretty amazed if this system developed 
into anything perse, "he says. "I think projects like this are great in terms of encouraging 
somebody, somewhere, to get very serious about this and dedicate the funds to 
developing the kind of aerial craft that can do it properly. 

"Many folks jumped the gun 1 5 years ago postulating about types of HAPs — 'wonder 
craft'that could stay up, roughly in one place, for months or years and carry all types 
of payloads and instruments. The problem is that as an aerospace project these things 
don't really exist yet. So what everybody has since realized is that you can't start big. It 
would be nice if you could, but you'll have to get there in an incremental way with small 
demonstrator and development projects which can kind of prove the technology." 


Figure 5.9 shows an excerpt from a press release by Google (2013) about 
Project Loon. Figure 5.10 is an excerpt from an article based on the press 
release. 


The writer describes the role his 
company hopes the public will play. 
The tone throughout this press 
release is that this is an ambitious 
project to address a problem that 
we can solve if we all work together. 


FIGURE 5.10 Article 
Based on a Press Release 

From Brian Handwerk, "Google's Loon 
Project Puts Balloon Technology in Spot- 
light," National Geographic Daily News, 
June 1 8, 201 3. Reprinted by permission 
of National Geographic. 


The writer begins with a description 
of the project, largely based on the 
information from the Google press 
release, as well as a link to the press 
release. 


The press release referred briefly to 
earlier attempts to use HAP. These 
earlier attempts will be a focus of 
this article. 


The writer introduces Tim Tozer, a 
HAP pioneer. The writer's interview 
with Tozer provides the focus of this 
article: an outsider's perspective on 
Project Loon. 


The article presents much more 
analysis by Tozer. His philosophy 
of technological progress — that it 
works best if scientists take small, 
incremental steps — is very different 
from that of Google, which prefers 
to take giant steps. 
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WRITER'S CHECKLIST 


Following is a checklist for analyzing your audience and 
purpose. Remember that your document might be read by 
one person, several people, a large group, or several groups 
with various needs. 

□ Did you fill out an audience profile sheet for your 
primary and secondary audiences? (p. 85) 

In analyzing your audience, did you consider the following 
questions about each of your most important readers: 

I What is your reader's educational background? (p. 87) 

I What is your reader's professional experience? (p. 87) 

EH What is your reader's job responsibility? (p. 87) 

I What are your reader's personal characteristics? (p. 88) 

I What are your reader's personal preferences? (p. 88) 

EH What are your reader's cultural characteristics? (p. 88) 

. I Why will the reader read your document? (p. 88) 

. What is your reader's attitude toward you? (p. 89) 

EH What is your reader's attitude toward the subject? (p. 89) 
} What are your reader's expectations about the 
document? (p. 90) 

EH How will your reader read your document? (p. 90) 

EJ What is your reader's reading skill? (p. 91) 

1 What is the physical environment in which your reader 
will read your document? (p. 91) 

In learning about your readers, did you 
! ] determine what you already know about them? (p. 92) 

□ interview people? (p. 92) 

read about your audience online? (p. 92) 

search social media for documents your audience has 
written? (p. 92) 

U analyze social-media data, if available? (p. 94) 

In planning to write for an audience from another culture, 
did you consider the following cultural variables: 

EH political? (p. 96) 

. economic? (p. 96) 


EH social? (p. 96) 

EH religious? (p. 96) 

I ! educational? (p. 96) 

EH technological? (p. 96) 

EH linguistic? (p. 96) 

In planning to write for an audience from another culture, 
did you consider other cultural variables: 

I ] focus on individuals or groups? (p. 97) 

EH distance between business life and private life? (p. 97) 
EH distance between ranks? (p. 98) 

EH need for details to be spelled out? (p. 98) 

EH attitudes toward uncertainty? (p. 98) 

In writing for a multicultural audience, did you 
EH limit your vocabulary? (p. 101) 

EH keep sentences short? (p. 101) 

I define abbreviations and acronyms in a glossary? 

(p. 101) 

LE avoid jargon unless you knew that your readers were 
familiar with it? (p. 101) 

I ] avoid idioms and slang? (p. 101) 

□ use the active voice whenever possible? (p. 101) 

□ use graphics carefully? (p. 101) 

EH have the document reviewed by someone from the 
reader's culture? (p. 101) 

EE In writing for multiple audiences, did you consider 
creating a modular document? (p.107) 

[ , Did you state your purpose in writing and express it in 
the form of a verb or verbs? (p. 1 08) 

I ] Did you get management's approval of your analysis of 
audience and purpose? (p. 109) 
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EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . Choose a 200-word passage from a technical article related 
to your major course of study and addressed to an expert 
audience. (You can find a technical article on the web by 
using Google Scholar or the Directory of Open Access 
Journals. In addition, many federal government agencies 
publish technical articles and reports on the web.) Rewrite 
the passage so that it will be clear and interesting to 

a general reader. Submit the original passage to your 
instructor along with your revision. 

2. The following passage is an advertisement for a 
translation service. Revise the passage to make it more 
appropriate for a multicultural audience. Submit the 
revision to your instructor. 

If your technical documents have to meet the needs of a 
global market but you find that most translation houses 
are swamped by the huge volume, fail to accommodate 
the various languages you require, or fail to make your 
deadlines, where do you turn? 

Well, your search is over. Translations, Inc. provides 
comprehensive translations in addition to full-service 
documentation publishing. 

We utilize ultrasophisticated translation programs 
that can translate a page in a blink of an eye. Then our 
crack linguists comb each document to give it that 
personalized touch. 

No job too large! No schedule too tight! Give us a call 
today! 

3. Study the website of a large manufacturer of computer 
products, such as Hewlett-Packard, Acer, Dell, or Lenovo. 


Identify three different pages that address different audi- 
ences and fulfill different purposes. Here is an example: 
Name of the page: Lenovo Group Fact Page 
Audience: prospective investors 
Purpose: persuade the prospective investor to invest in 
the company 

Be prepared to share your findings with the class. 

4. TEAM EXERCISE Form small groups and study two 
websites that advertise competing products. For instance, 
you might choose the websites of two car makers, two 
television shows, or two music producers. Have each 
person in the group, working alone, compare and contrast 
the two sites according to these three criteria: 

a. the kind of information they provide: hard, technical 
information or more emotional information 

b. the use of multimedia such as animation, sound, or 
video 

c. the amount of interactivity they invite — that is, the 
extent to which you can participate in activities 
while you visit the site 

After each person has separately studied the sites and 
taken notes about the three criteria, come together as 
a group. After each person shares his or her findings, 
discuss the differences as a group. Which aspects 
of these sites caused the most difference in group 
members' reactions? Which aspects seemed to elicit 
the most consistent reactions? In a brief memo to your 
instructor, describe and analyze how the two sites were 
perceived by the different members of the group. 


§P=i For more practice with the concepts covered in this chapter, 
M complete the LearningCurve activity "Analyzing Your Audience 
and Purpose" under "Additional Resources" in Ch. 5: 

macmillanhighered.com/launchpad/techcomm1 1 e. 


CASE 5: Focusing on an Audience's Needs and Interests 



You're interning in the marketing department of a cell-phone service provider, and your 
supervisor has asked you to perform research into a competing provider's products and 
services for the over-65 market, paying special attention to the ways in which the company 
successfully appeals to the needs and interests of its audience. She then asks you to 
prepare an oral presentation about your findings. To begin your project, go to "Cases" 
under "Additional Resources" in Ch. 5 at macmillanhighered.com/launchpad 
/techcommlle. 
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IN THE WORKPLACE, you will conduct research all the time. As a buyer for a 
clothing retailer, for example, you might need to conduct research to help you 
determine whether a new line of products would be successful in your store. 

As a civil engineer, you might need to perform research to determine whether 
to replace your company's traditional surveying equipment with GPS-based 
gear. And as a pharmacist, you might need to research whether a prescribed 
medication might have a harmful interaction with another medication a patient is 
already taking. 

In the workplace, you will conduct research using a variety of methods. You 
will consult websites, blogs, and discussion boards, and you might listen to 
podcasts or watch videos. Sometimes you will interview people, and you will 
likely distribute surveys electronically to acquire information from customers and 
suppliers. Regardless of which technique you use, your challenge will be to sort 
the relevant information from the irrelevant, and the accurate from the bogus. 

This chapter focuses on conducting primary research and secondary research. 
Primary research involves discovering or creating technical information yourself. 
Secondary research involves finding information that other people have already 
discovered or created. This chapter presents secondary research first. Why? 
Because you will probably do secondary research first. To design the experiments 
or the field research that goes into primary research, you need a thorough 
understanding of the information that already exists about your subject. 


Understanding the Differences Between 
Academic and Workplace Research 

Although academic research and workplace research can overlap, in most 
cases they differ in their goals and their methods. 

In academic research, your goal is to find information that will help answer 
a scholarly question: “What would be the effect on the trade balance between 
the United States and China if China lowered the value of its currency by 
10 percent?” or “At what age do babies learn to focus on people’s eyes?” Aca- 
demic research questions are often more abstract than applied. That is, they 
get at the underlying principles of a phenomenon. Academic research usually 
requires extensive secondary research: reading scholarly literature in aca- 
demic journals and books. If you do primary research, as scientists do in labs, 
you do so only after extensive secondary research. 
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In workplace research, your goal is to find information to help you answer 
a practical question: “Should we replace our sales staffs notebook comput- 
ers with tablets?” or “What would be the advantages and disadvantages 
to our company of adopting a European-style privacy policy for customer 
information?” Workplace research questions frequently focus on improving 
a situation at a particular organization. These questions call for considerable 
primary research because they require that you learn about your own orga- 
nization’s processes and how the people in your organization would respond 
to your ideas. Sometimes, workplace research questions address the needs 
of customers or other stakeholders. You will need a thorough understanding 
of your organization’s external community in order to effectively align your 
products or services with their needs. 

Regardless of whether you are conducting academic or workplace 
research, the basic research methods — primary and secondary research — are 
fundamentally the same, as is the goal: to help you answer questions. 


Understanding the Research Process 

When you perform research, you want the process to be effective and effi- 
cient. That is, you want to find information that answers the questions you 
need to answer. And you don’t want to spend any more time than necessary 
getting that information. To meet these goals, you have to think about how 
the research relates to the other aspects of the overall project. The Focus 
on Process box provides an overview of the research process. Although 
all these tasks are described as part of the planning stage, remember that 
you might also need to perform additional research during the drafting, 
revising, editing, and proofreading stages. Whenever you need additional 
information to help you make your argument clear and persuasive, do more 
research. 


Choosing Appropriate Research Methods 

Different research questions require different research methods. Once you 
have determined the questions you need to answer, think about the various 
research techniques you could use to answer them. 

For example, your research methods for finding out how a current situa- 
tion is expected to change would differ from your research methods for find- 
ing out how well a product might work for your organization. That is, if you 
want to know how outsourcing will change the computer-support industry 
over the next 10 to 20 years, you might search for long-range predictions 
in journal and magazine articles and on reputable websites and blogs. By 
contrast, if you want to figure out whether a specific scanner will produce 
the quality of scan that you need and will function reliably, you might do 
the same kind of secondary research and then observe the operation of the 
scanner at a vendor’s site; schedule product demos at your site; follow up by 
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PLANNING 


Analyze your audience. Who are your most important 
readers? What are their personal characteristics, their attitudes 
toward your subject, their motivations for reading? If you are 
writing to an expert audience that might be skeptical about 
your message, you need to do a lot of research to gather the 
evidence for a convincing argument. See Ch. 5. 

Analyze your purpose. Why are you writing? Understanding 
your purpose helps you understand the types of information 
readers will expect. Think in terms of what you want your 
readers to know or believe or do after they finish reading your 
document. See Ch. 5. 

Analyze your subject. What do you already know about your 
subject? What do you still need to find out? Using techniques 
such as freewriting and brainstorming, you can determine 
those aspects of the subject you need to investigate. See Ch. 3. 
Visualize the deliverable. What application will you need 
to deliver: a proposal, a report, a website? What kind of oral 
presentation will you need to deliver? See Ch. 3. 

Work out a schedule and a budget for the project. When 
is the deliverable due? Do you have a budget for phone calls, 
database searches, or travel to libraries or other sites? See 
Ch. 3. 

Determine what information will need to be part of that 
deliverable. Draft an outline of the contents, focusing on the 
kinds of information that readers will expect to see in each 
part. See Ch. 3. 

Determine what information you still need to acquire. Make 
a list of the pieces of information you don't yet have. 

Create questions you need to answer in your deliverable. 

Writing the questions in a list forces you to think carefully 
about your topic. One question suggests another, and soon 
you have a lengthy list that you need to answer. 

Conduct secondary research. Study journal articles and 
web-based sources such as online journals, discussion boards, 
blogs, and podcasts. 

Conduct primary research. You can answer some of your 
questions by consulting company records, by interviewing 
experts in your organization, by distributing questionnaires, and 
by interviewing other people in your organization and industry. 
Other questions call for using social media to gather information 
from your customers, suppliers, and other stakeholders. 

Evaluate your information. Once you have your information, 
you need to evaluate its quality: is it accurate, comprehensive, 
unbiased, and current? 

Do more research. If the information you have acquired 
doesn't sufficiently answer your questions, do more research. 
And if you have thought of additional questions that need 
to be answered, do more research. When do you stop doing 
research? You will stop only when you think you have enough 
high-quality information to create the deliverable. 
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interviewing others in your company; and perform an experiment in which 
you try two different scanners and analyze the results. 

Table 6.1 provides a good starting point for thinking about how to acquire 
the information you need. You are likely to find that your research plan 
changes as you conduct your research. You might find, for instance, that you 
need more than one method to get the information you need or that the one 
method you thought would work doesn’t. Still, having a plan can help you 
discover the most appropriate methods more quickly and efficiently. 


TABLE 6.1 Research Questions and Methods 


TYPE OF QUESTION 

EXAMPLE OF QUESTION 

APPROPRIATE RESEARCH TECHNIQUE 

What is the theory behind this 
process or technique? 

How do greenhouse gases 
contribute to global warming? 

Encyclopedias, handbooks, and journal articles present 
theory. Also, you can find theoretical information on 
websites of reputable professional organizations and 
universities. Search using keywords such as "greenhouse 
gases"and "global warming." 

What is the history of this 
phenomenon? 

When and how did engineers 
first try to extract shale oil? 

Encyclopedias and handbooks present history. Also, you 
can find historical information on websites of reputable 
professional organizations and universities. Search using 
keywords such as "shale oil" and "petroleum history." 

What techniques are being 
used now to solve this 
problem? 

How are companies 
responding to the federal 
government's new laws on 
health-insurance portability? 

If you need recent information, you will have better luck 
using digital resources such as websites and social media 
than using traditional print media. Search using keywords 
and tags such as "health-insurance portability."Your search 
will be most effective if you use standard terminology, such 
as"HIPAA"forthe health-insurance law. 

How is a current situation 
expected to change? 

What changes will outsourcing 
cause in the computer-support 
industry over the next 1 0 to 
20 years? 

For long-range predictions, you can find information in 

journal articles and magazine articles and on reputable 
websites. Experts might write forecasts on discussion 
boards and blogs. 

What products are available 
to perform a task or provide a 
service? 

Which vendors are available 
to upgrade and maintain our 
company's website? 

For products and services, search websites, discussion 
boards, and blogs. Reputable vendors — manufacturers and 
service providers — have sites describing their offerings. But 
be careful not to assume vendors'claims are accurate. Even 
the specifications they provide might be exaggerated. 

What are the strengths and 
weaknesses of competing 
products and services? 

Which portable GPS system is 
the lightest? 

Search for benchmarking articles from experts in the field, 
such as a journal article (either in print or on the web) 
about camping and outfitting that compares the available 
GPS systems according to reasonable criteria. Also check 
discussion boards for reviews and blogs for opinions. If 
appropriate, do field research to answer your questions. 

Which product or service do 
experts recommend? 

Which four-wheel-drive SUV 
offers the best combination 
of features and quality for our 
needs? 

Experts write journal articles, magazine articles, and 
sometimes blogs. Often, they participate in discussion 
boards. Sometimes, you can interview them, in person or 
on the phone, or write them inquiries. 


( continued ) 
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TABLE 6.1 Research Questions and Methods ( continued ) 


TYPE OF QUESTION 

EXAMPLE OF QUESTION 

APPROPRIATE RESEARCH TECHNIQUE 

What do our stakeholders think 
about a current or proposed 
product or service? 

Would the public like to see us 
add a plug-in hybrid version 
to our line of small SUVs? 

How would we market it to 
distinguish it from the existing 
hybrid small SUVs? 

Study journal and magazine articles or influential blogs or 
post a question on a company blog or on a microblogging 
site such asTumblrand ask for responses. Also consider 
analyzing social-media data, using software to capture and 
measure keywords from social-media platforms. 

What are the facts about 
how we do our jobs at this 
company? 

Do our chemists use gas 
chromatography in their 
analyses? 

Sometimes, you can interview someone, in person or on 
the phone, to answer a simple question. To determine 
whether your chemists use a particular technique, start by 
asking someone in the relevant department. 

What can we learn about 
what caused a problem in our 
organization? 

What caused the 
contamination in the clean 
room? 

You can interview personnel who were closest to the 
problem and inspect the scene to determine the cause of 
the problem. 

What do our personnel 
think we should do about a 
situation? 

Do our quality-control analysts 
think we need to revise our 
sampling quotient? 

If there are only a few personnel, interview them. If there 
are many, use questionnaires to get the information more 
quickly. 

How well would this product 
or service work in our 
organization? 

Would this scanner produce 
the quality of scan that we 
need and interface well with 
our computer equipment? 

Read product reviews on reputable websites. Study 
discussion boards. Observe the use of the product or 
service at a vendor's site. Schedule product demos at your 
site. Follow up by interviewing others in your company to 
get their thinking. Do an experiment in which you try two 
different solutions to a problem and then analyze the results. 


4 \ 


GUIDELINES 


Researching a Topic 


Follow these three guidelines as you gather information to use in your document. 


► Be persistent. Don't be discouraged if a research method doesn't yield useful 
information. Even experienced researchers fail at least as often as they succeed. 
Be prepared to rethink how you might find the information. Don't hesitate to ask 
reference librarians for help or to post questions on discussion boards. 

► Record your data carefully. Prepare the materials you will need. Write informa- 
tion down, on paper or electronically. Record interviews (with the respondents' 
permission). Paste the URLs of the sites you visit into your notes. Bookmark sites 
so that you can return to them easily. 

► Triangulate your research methods. Triangulating your research methods means 
using more than one or two methods. If a manufacturer's website says a printer 
produces 1 7 pages per minute, an independent review in a reputable journal also 
says 1 7, and you get 1 7 in a demo at your office with your documents, the printer 
probably will produce 1 7 pages per minute. When you need to answer important 
questions, don't settle for only one or two sources. 
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If you are doing research for a document that will be read by people from 
other cultures, think about what kinds of evidence your readers will consider 
appropriate. In many non-Western cultures, tradition or the authority of the per- 
son making the claim can be extremely important, in some cases more impor- 
tant than the kind of scientific evidence that is favored in Western cultures. 

And don’t forget that all people pay particular attention to information 
that comes from their own culture. If you are writing to European readers 
about telemedicine, for instance, try to find information from European 
authorities and about European telemedicine. This information will 
interest your readers and will likely reflect their cultural values and 
expectations. 

Conducting Secondary Research 

When you conduct secondary research, you are trying to learn what experts 
have to say about a topic. Whether that expert is a world-famous scientist 
revising an earlier computer model about the effects of climate change on 
agriculture in Europe or the head of your human-resources department 
checking company records to see how the Affordable Care Act changed the 
way your company hired part-time workers last year, your goal is the same: 
to acquire the best available information — the most accurate, most unbiased, 
most comprehensive, and most current. 

Sometimes you will do research in a library, particularly if you need special- 
ized handbooks or access to online subscription services that are not freely 
available on the Internet. Sometimes you will do your research on the web. As 
a working professional, you might find much of the information you need in 
your organization’s information center. An information center is an organization’s 
library, a resource that collects different kinds of information critical to the orga- 
nization’s operations. Many large organizations have specialists who can answer 
research questions or who can get articles or other kinds of data for you. 

UNDERSTANDING THE RESEARCH MEDIA 

Today, most technical information is distributed not only in print but also 
through digital media accessible on the Internet. You will probably use infor- 
mation published in four major media: 

• Print. Books, journals, reports, and other documents will continue to be 
produced in print because printed documents are portable and you can 
write on them. For documents that do not need to be updated periodically, 
print remains a useful and popular medium. To find printed documents, 
you will use online catalogs. 

• Online databases. Most libraries — even many public libraries — subscribe 
to services, such as LexisNexis, ProQuest, InfoTrac, Gale Virtual Reference, 
and ERIC, that provide access to large databases of journal articles, 
conference proceedings, newspapers, and other documents. 
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• Websites. The good news is that there are billions of pages of information 
on the web. The bad news is that there are billions of pages of information 
on the web. Still, if you search effectively and efficiently, you can find 
reference materials such as dictionaries and encyclopedias that don’t exist 
in print, online versions of magazines and journals with extra features not 
present in the print versions, conversion calculators and other statistical 
software, current survey data, animations, audio and video podcasts, and 
many other kinds of information. 

• Social media. This is a broad term encompassing several kinds of media, 
all of which include user-generated content. A discussion board is an 
online discussion that readers contribute to by posting messages. Most 
discussion boards are organized by threads (sometimes called topics). 

All of the posts on a thread are presented together, usually in reverse- 
chronological order. A blog is a web log, a web-based periodical published 
by a person or group, to which readers can contribute comments. A wiki is 
a document or website that users write and edit online. 

USING TRADITIONAL RESEARCH TOOLS 

There is a tremendous amount of information in the different media. The 
trick is to learn how to find what you want. This section discusses six basic 
research tools. 

Online Catalogs An online catalog is a database of books, microform mate- 
rials, films, compact discs, phonograph records, tapes, and other materials. In 
most cases, an online catalog lists and describes the holdings at one particular 
library or a group of libraries. Your college library has an online catalog of its 
holdings. To search for an item, consult the instructions, which explain how to 
limit your search by characteristics such as types of media, date of publication, 
and language. The instructions also explain how to use punctuation and words 
such as and, or, and not to focus your search effectively. 

Reference Works Reference works include general dictionaries and ency- 
clopedias, biographical dictionaries, almanacs, atlases, and dozens of other 
research tools. These print and online works are especially useful when you 
are beginning a research project because they provide an overview of the 
subject and often list the major works in the field. 

How do you know if there is a dictionary of the terms used in a given field? 
The following reference books — the guides to the guides — list some of the 
many resources available: 

Hacker, D., and Fister, B. Research and documentation online (5th ed.). http:// 
dianahacker.com/resdoc 

Kennedy, X. ]., Kennedy, D. M., and Muth, M. F. (2014). The Bedford guide 
for college writers with reader, research manual, and handbook (10th ed.). 
Boston: Bedford/St. Martin’s. 
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Lester, R. (Ed.). (2008). The new Walford guide to reference resources (Vol. 1: Science, 
Technology and Medicine; Vol. 2: Social Sciences). London: Neal-Schuman. 
Palmquist, M. The Bedford researcher, http://bcs.bedfordstmartins.com 
/bedfordresearcher/links/disciplines-art.asp 

To find information on the web, go to the “reference” section of a library 
website or search engine. There you will find links to excellent collections of 
reference works online, such as Infomine and ipl2. 

Periodical Indexes Periodicals are excellent sources of information 
because they offer recent, authoritative discussions of specific subjects. The 
biggest challenge in using periodicals is identifying and locating the dozens 
of articles relevant to any particular subject that are published each month. 
Although only half a dozen major journals might concentrate on your field, 
a useful article could appear in one of hundreds of other publications. A 
periodical index, which is a list of articles classified according to title, subject, 
and author, can help you determine which journals you want to locate. 

There are periodical indexes in all fields. The following brief list will give 
you a sense of the diversity of titles: 

• Applied Science & Technology Index 

• Business Source Premier 

• Engineering Village 

• Readers’ Guide to Periodical Literature 

You can also use a directory search engine. Many directory categories include a 
subcategory called “journals” or “periodicals” listing online and printed sources. 

Once you have created a bibliography of printed articles you want to study, 
you have to find them. Check your library’s online catalog, which includes all 
the journals your library receives. If your library does not have an article you 
want, you can use one of two techniques for securing it: 

• Interlibrary loan. Your library finds a library that has the article. That 
library scans the article and sends it to your library. This service can take 
more than a week. 

• Document-delivery service. If you are in a hurry, you can log on to a 
document-delivery service, such as IngentaConnect, a free database of 
6 million articles in 12 thousand periodicals. There are also fee-based 
document-delivery services. 

Newspaper Indexes Many major newspapers around the world are indexed 
by subject. The three most important indexed U.S. newspapers are the following: 

• the New York Times, perhaps the most reputable U.S. newspaper for 
national and international news 

• the Christian Science Monitor, another highly regarded general newspaper 

• the Wall Street Journal, the most authoritative news source on business, 
finance, and the economy 
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Many newspapers available on the web can be searched electronically, 
although sometimes there is a charge for archived articles. Keep in mind that 
the print version and the electronic version of a newspaper can vary greatly. 
If you wish to quote from an article in a newspaper, the print version is the 
preferred one. 


Abstract Services Abstract services are like indexes but also provide 
abstracts: brief technical summaries of the articles. In most cases, reading 
the abstract will enable you to decide whether to seek out the full article. The 
title of an article alone can often mislead you about its contents. 

Some abstract services, such as Chemical Abstracts Service, cover a broad 
field, but many are specialized rather than general. Fuente Academica, for 
instance, focuses on Basque studies. Figure 6.1 shows an abstract from 
AnthroSource, an abstract service covering anthropology journals. 

Government Information The U.S. government is the world’s biggest 
publisher. In researching any field of science, engineering, or business, you 
are likely to find that a federal agency or department has produced a relevant 
brochure, report, or book. 

Government publications are cataloged and shelved separately from other 
kinds of materials. They are classified according to the Superintendent of 
Documents system, not the Library of Congress system. A reference librar- 
ian or a government documents specialist at your library can help you use 
government publications. 


PLOT AND IRONY IN CHILDBIRTH NARRATIVES 
OF MIDDLE-CLASS BRAZILIAN WOMEN 

Brazil's rate of cesarean deliveries is among the highest in the world and 
constitutes the majority of childbirths in private hospitals. This study 
examines ways middle-class Brazilian women are exercising agency in this 
context. It draws from sociolinguistics to examine narrative structure and 
dramatic properties of 1 20 childbirth narratives of 68 low- to high-income 
women. Surgical delivery constituted 62% of the total. I focus on 20 young 
middle-class women, of whom 1 7 had C-sections. Doctors determined 
mode of childbirth pre-emptively or appeared to accommodate women's 
wishes, while framing the scenario as necessitating surgical delivery. The 
women strove to imbue C-section deliveries with value and meaning through 
staging, filming, familial presence, attempting induced labor, or humanized 
childbirth. Their stories indicate that class privilege does not lead to choice 
over childbirth mode. The women nonetheless struggle over the significance 
of their agency in childbirth. 


FIGURE 6.1 An Abstract from AnthroSource 

Source: Abstract from Maureen O'Dougherty, "Plot and Irony in Childbirth Narratives of Middle-Class Brazilian \Nomer\" Medi- 
cal Anthropology Quarterly, Volume 27, Issue 1, pages 43-62, March 2013. © 2013 by the American Anthropological Associa- 
tion. Reprinted by permission of John Wiley & Sons, Inc. 


For more about abstracts, see 
Ch. 18, p. 479. 
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For more about RFPs, see Ch. 16, 
p. 422. 


To watch a tutorial on using 
online tools to organize your 
research, go to Ch. 6 > Additional 
Resources > Tutorials: 

macmillanhighered.com 
/launchpad/techcomml 1 e. 


You can also access various government sites and databases on the Inter- 
net. For example, if your company wishes to respond to a request for propos- 
als (RFP) published by a federal government agency, you will find that RFP on 
a government site. The major entry point for federal government sites is USA 
.gov (usa.gov), which links to hundreds of millions of pages of government 
information and services. It also features tutorials, a topical index, online 
transactions, and links to state and local government sites. 

USING SOCIAL MEDIA AND OTHER INTERACTIVE RESOURCES 

Social media and other interactive resources enable people to collaborate, 
share, link, and generate content in ways that traditional websites offering 
static content cannot. The result is an Internet that can harness the collec- 
tive intelligence of people around the globe — and do so quickly. However, the 
ease and speed with which new content can be posted, as well as the lack of 
formal review of the content, creates challenges for people who do research 
on the Internet. Everyone using social-media resources must be extra cau- 
tious in evaluating and documenting sources. 

This discussion covers three categories of social media and web-based 
resources used by researchers — discussion boards, wikis, and blogs — as well 
as two techniques for streamlining the process of using these resources: 
tagged content and RSS. 

Discussion Boards Discussion boards, online discussion forums spon- 
sored by professional organizations, private companies, and others, enable 
researchers to tap a community’s information. Discussion boards are espe- 
cially useful for presenting quick, practical advice. However, the advice might 
or might not be authoritative. Figure 6.2 shows one interchange related to 
starting a business as a foreign national. 

Wikis A wiki is a website that makes it easy for members of a community, 
company, or organization to create and edit content collaboratively. Often, a 
wiki contains articles, information about student and professional confer- 
ences, reading lists, annotated sets of links, book reviews, and documents 
used by members of the community. You might have participated in creating 
and maintaining a wiki in one of your courses or as a member of a commu- 
nity group outside of your college. 

Wikis are popular with researchers because they contain information that 
can change from day to day, on topics in fields such as medicine or business. In 
addition, because wikis rely on information contributed voluntarily by mem- 
bers of a community, they represent a much broader spectrum of viewpoints 
than media that publish only information that has been approved by editors. 
For this reason, however, you should be especially careful when you use wikis; 
the information they contain might not be trustworthy. It’s a good idea to cor- 
roborate any information you find on a wiki by consulting other sources. 

An excellent example of how organizations use wikis is provided by the fed- 
eral government’s Mobile Gov, a set of wikis whose purpose is to make “any- 
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Community 


Search Community 


Starch 


FIGURE 6.2 A Discus- 
sion Board Exchange 

Source: Small Business Administration, 
2014: http://www.sba.gov/community 
/discussion-boards/starting-business 
-us-foreign-national. 


Starting a Business in the US as a Foreign 
National 


Crtattd: July 15 2014 12 20 pm 


Hello, I am interested to open a branch of my company in US and before contacting professional that could assist me 
would like to have a general idea on the steps and requirements that I must fulfill. I saw from older posts that there 
was a blog available with those infos but it seems the link it does not work anymore. Any suggestion is very helpfull! 


Tip DIkih P opular Topic* Starting!* Rogiturtng a Ivtlnnt 


This comment was removed from public view (Spam). Please review the Community Rules 
of Conduct for more information. 


If you use a search engine to find 
this interchange, you are perform- 
ing secondary research: discovering 
what has already been written 
or said about a topic. If you post 
a question to a discussion board 
(or comment on a blog post) and 
someone responds, you are per- 
forming primary research, just as if 
you were interviewing that person. 
For more on primary research, see 
p. 1 30. But don't worry too much 
about whether you are doing pri- 
mary or secondary research; worry 
about whether the information is 
accurate and useful. 


bkline | Co: 


tor I 7/ 15/201.) - I2t; 


Hi. you may lino this SBA blog post useful Starling a Business In the U S as a Foreign 
National Best of luck to you! 


Moderators who oversee discussion 
boards routinely delete comments 
from trolls advertising weight-loss 
solutions and other scams. 


time, anywhere, any-device government services and info” available to other 
government agencies, businesses, and the general public. These wikis enable 
all these stakeholders to contribute technical information and advice about 
how to help government agencies make their services available from mobile 
devices. A recent post by the World Wide Web Consortium (W3C), the stan- 
dards agency for the web, explained that the barriers to using websites on a 
mobile device are similar to the barriers faced by people with disabilities when 
they try to use websites on any device. The post by W3C included detailed 
recommendations and links to information that can help developers make the 
transition to responsive web design. In other words, the wiki provided a forum 
for experts on web accessibility to help federal agencies provide services. 

How do you search wikis? You can use any search engine and add the 
word “wiki” to the search. Or you can use a specialized search engine such as 
Wiki.com. 

Blogs Many technical and scientific organizations, universities, and private For more about blogs, see Ch. 14, 

companies sponsor blogs that offer useful information for researchers. P- 377 

Keep in mind that bloggers are not always independent voices. A Hewlett- 
Packard employee writing on a company-sponsored blog will likely be pre- 
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tfASA 


Amber Jenkins is EtWor of 
NASA's Cfcmate Change 
website and project 
manager of the Center for 
Ctanate Sciences at 
NASA's Jet Propulsion 
Laboratory She's 
passionate about climate 
change, science and 
science communication 


GLOBAL CLIMATE CHANGE 

NASA's Eyes on the Earth 


National Aeronautics and 
Space Administration 


Climate change chronicles from NASA 


Global warming consensus 

Agreement among scientists confirmed, again 


June 13.2013 
posted by Erik Conway 
14:59 POT 


Subscribe to our blog 
feed and youtl never 
miss a post' 




Donn «t •) 200*. AnMtcgo el at 2010 

Credit Hustraten of the scientific consensus that 97 out of 100 actwety publishing dmate scientists 
agree wlh the averwheknng evidence that humans are causng global warning Courtesy of 
Skeptical Science 




• Global warming consensus 

• Entering unknown territory 

• Ask the expert 

• Geltlng past I'm smart 
you're stupiff 


FIGURE 6.3 A Blog 

In the first ten days after it went online, this post was liked 522 times on Facebook, was tweeted 86 times on 
Twitter, and elicited 1 1 comments from readers. Almost all blogs invite readers to post comments or questions. 
Source: NASA, 2013: http://climate.nasa.gov/blog/938. Illustration reprinted by permission of John Cook. 


senting the company’s viewpoint on the topic. Don’t count on that blogger to 
offer objective views about products. 

Figure 6.3, a screenshot of a portion of NASA’s My Big Fat Planet blog, 
offers information that is likely to be credible, accurate, and timely. 

Tagged Content Tags are descriptive keywords people use to categorize and 
label content such as blog entries, videos, podcasts, and images they post to 
the Internet or bookmarks they post to social-bookmarking sites. Tags can be 
one-word descriptors without spaces or punctuation (such as “sandiegozoo”) 
or multiword descriptors (such as “San Diego Zoo”). More and more social- 
media platforms, including Facebook, have adopted the hashtag (#) as a way to 
tag an item to make it easier to find by searching. 

Figure 6.4 shows search results for blogs tagged with “Google Glass” on 
Technorati, a site that currently tracks more than a hundred million blogs 
and a quarter billion pieces of tagged social media. 

RSS Feeds Repeatedly checking for new content on many different 
websites can be a time-consuming and haphazard way to research a topic. 
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Posts Google Glass 


PRTechnorati 


f Women Technology Business Entertainment Lifestyle Sports Politics Videos Social 


E 


Blog Directory Top 100 Tags People Write for Technorati 


Blogs relating to “Google Glass” (10 blogs found out of 03QS 


Page: 1 

Look up <P "Google”. (P "Glass" at The Free Dictionary 



m 

nr 

google glassware blog, google ... L* : 

10 http://google-glassware.conVgoogle-giassware-t>log/ ’ Auth: 1 

12797. 

Q 

I** 

< oan~ 5 : : 

- ■ . 

ftkl 

Gadgetalks 

0 htlpV/www.gadgetaUcs.corrV Auth. 11 2 

Recent LG Optimus G2, LG Optimus L9 II and 
LG-D500 coming soon 

With the great success from LG Nexus 4. now LG is 
going to launch its new smartphones soon. There is 

a ... 


FIGURE 6.4 Search Results for Blogs Tagged with "Google Glass" 

This search returned 1 0 blogs that relate to the topic of Google Glass. Readers could also search for 
individual posts about the topic on other social media and get even more responses. The Technorati 
Authority figure, which is abbreviated as “Auth" on the right, measures how many other sites refer to the 
blog, reflecting its popularity. 

Source: Technorati, 2013: www.technorati.com. Reprinted by permission of Technorati Media. 


RSS (short for rich site summary or really simple syndication) technology allows 
readers to check just one place (such as a software program running on 
their computer or an email program) for alerts to new content posted on 
selected websites. Figure 6.5 shows a website that offers RSS feeds. Readers 
use a special type of software program called an RSS aggregator to be alerted 
by RSS feeds (notifications of new or changed content from sites of interest 
to them). 


EVALUATING THE INFORMATION 

You’ve taken notes, paraphrased, and quoted from your secondary research. 
Now, with more information than you can possibly use, you try to figure out 
what it all means. You realize that you still have some questions — that some 
of the information is incomplete, some contradictory, and some unclear. 
There is no shortage of information; the challenge is to find information that 


For more about taking notes, 
paraphrasing, and quoting, see 
Appendix, Part A, p. 606. 
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FIGURE 6.5 A Website Offering RSS Feeds 

This page shows how to use RSS feeds on the Library of Congress website. 
Source: Library of Congress, 2013: www.loc.gov/rss/. 


is accurate, unbiased, comprehensive, appropriately technical, current, and 

clear. 

• Accurate. Suppose you are researching whether your company should 
consider flextime scheduling. If you estimate the number of employees 
who would be interested in flextime to be 500 but it is in fact closer to 50, 
inaccurate information will cause you to waste time doing an unnecessary 
study. 

• Unbiased. You want sources that have no financial stake in your project. 

A private company that transports workers in vans is likely to be a biased 
source because it could profit from flextime, making extra trips to bring 
employees to work at different times. 

• Comprehensive. You want information from different kinds of people — 
in terms of gender, cultural characteristics, and age — and from people 
representing all viewpoints on the topic. 

• Appropriately technical. Good information is sufficiently detailed to 
respond to the needs of your readers, but not so detailed that they cannot 
understand it or do not need it. For the flextime study, you need to find out 
whether opening your building an hour earlier and closing it an hour later 
would significantly affect your utility costs. You can get this information 
by interviewing people in the Operations Department; you do not need to 
do a detailed inspection of all the utility records of the company. 

• Current. If your information is 10 years old, it might not accurately reflect 
today’s situation. 
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• Clear. You want information that is easy to understand. Otherwise, you’ll 
waste time figuring it out, and you might misinterpret it. 

The most difficult kind of material to evaluate is user-generated content 
from the Internet — such as information on discussion boards or in blogs — 
because it rarely undergoes the formal review procedure used for books and 
professional journals. A general principle for using any information you find 
on the Internet is to be extremely careful. Because content is unlikely to have 
been reviewed before being published on a social-media site, use one or more 
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Evaluating Print and Online Sources 


FOR PRINTED SOURCES 
► Authorship 

Do you recognize the name of the 
author? Does the source describe 
the author's credentials and current 
position? If not, can you find this 
information in a "who's who" or by 
searching for other books or other 
journal articles by the author? 


► Publisher 

What is the publisher's reputation? A 
reliable book is published by a repu- 
table trade, academic, or scholarly 
publisher; a reliable journal is spon- 
sored by a professional association 
or university. Are the editorial board 
members well known? 

Trade publications — magazines about 
a particular industry or group — often 
promote the interests of that industry 
or group. For example, information in 
a trade publication for either loggers 
or environmentalists might be biased. 

If you doubt the authority of a book 
or journal, ask a reference librarian ora 
professor. 


FOR ONLINE SOURCES 

If you do not recognize the author's 
name, is the site mentioned on another 
reputable site? Does the site contain 
links to other reputable sites? Does it 
contain biographical information — 
the author's current position and cre- 
dentials? Can you use a search engine 
to find other references to the author's 
credentials? Be especially careful with 
unedited sources such as Wikipedia; 
some articles in it are authoritative, 
others are not. Be careful, too, with 
blogs, some of which are written by 
disgruntled former employees with a 
score to settle. 

Can you determine the publisher's 
identity from headers or footers? Is the 
publisher reputable? 

If the site comes from a personal ac- 
count, the information it offers might be 
outside the author's field of expertise. 
Many Internet sites exist largely for pub- 
lic relations or advertising. For instance, 
websites of corporations and other orga- 
nizations are unlikely to contain self-crit- 
ical information. For blogs, examine the 
blogroll, a list of links to other blogs and 
websites. Credible blogs are likely to link 
to blogs already known to be credible. If 
a blog links only to the author's friends, 
blogs hosted by the same corporation, 
or blogs that express the same beliefs, 
be very cautious. 


( continued ) 
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FOR PRINTED SOURCES 


FOR ONLINE SOURCES 


► Knowledge of the literature 

Does the author appear to be 
knowledgeable about the major 
literature on the topic? Is there 
a bibliography? Are there notes 
throughout the document? 


Analyze the Internet source as you 
would any other source. Often, refer- 
ences to other sources will take the 
form of links. 


Accuracy and verifiability of the information 


Is the information based on reason- 
able assumptions? Does the author 
clearly describe the methods and 
theories used in producing the in- 
formation, and are they appropriate 
to the subject? Has the author used 
sound reasoning? Has the author 
explained the limitations of the 
information? 


► Timeliness 

Does the document rely on recent 
data? Was the document published 
recently? 


Is the site well constructed? Is the 
information well written? Is it based on 
reasonable assumptions? Are the claims 
supported by appropriate evidence? Has 
the author used sound reasoning? Has 
the author explained the limitations of 
the information? Are sources cited? On- 
line services such as BlogPulse help you 
evaluate how active a blog is, how the 
blog ranks compared to other blogs, and 
who is citing the blog. Active, influential 
blogs that are frequently linked to and 
cited by others are more likely to contain 
accurate, verifiable information. 

Was the document created recently? 
Was it updated recently? If a site is not 
yet complete, be wary. 


trusted sources to confirm the information you locate. Some instructors do 
not allow their students to use blogs or wikis, including Wikipedia, for their 
research. Check with your instructor to learn his or her policies. 


Conducting Primary Research 

Although the library and the Internet offer a wealth of authoritative infor- 
mation, in the workplace you will often need to conduct primary research 
because you need new information. There are eight major categories of 
primary research: analysis of social-media data, observations and demon- 
strations, inspections, experiments, field research, interviews, inquiries, and 
questionnaires. 

ANALYSIS OF SOCIAL-MEDIA DATA 

Every hour, people post about 30 million comments, about 7 million photos, 
and some 453 years of video footage on social media (McCaney, 2013). A tor- 
rent of information is continuously coming online, and many organizations 
are working hard to sift through it to find useful insights. 
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DOCUMENT ANALYSIS ACTIVITY 


Evaluating Information from Internet Sources 


How can you ignore thousands of scientists who say manmade global warming 
is a serious threat? 

The idea that there is a "scientific consensus" does not hold up. Scientists who 
are skeptical about "dangerous manmade climate change" have been speaking 
out for years. Just this year, two prominent former believers in man-made global 
warming announced they were reconsidering the science. 

"Gaia" scientist James Lovelock had been "alarmist" about climate change for 
years. Now he says "The problem is we don't know what the climate is doing. We 
thought we knew 20 years ago." 

German meteorologist Klaus-Eckart Puls also reversed his belief in man-made 
global warming in 201 2 and called the idea C0 2 can regulate climate "sheer 
absurdity." "Ten years ago I simply parroted what the IPCC told us," he said. "One 
day I started checking the facts and data. First I started with a sense of doubt, 
but then I became outraged when I discovered that much of what the IPCC and 
media were telling us was sheer nonsense and was not even supported by any 
scientific facts and measurements. To this day, I still feel shame that as a scientist I 
made presentations of their science without first checking it." 

In 201 0, a report documented that More Than 1 000 International Scientists 
Dissented Over Man-Made Global Warming Claims . Many of them were former 
IPCC scientists. Climate scientist Mike Hulme ismantled the "thousands 
of scientists agree" cla put forth by the United Nations and news media. 

Claims that"2,500 of the world's leading scientists have reached a consensus 
that human activities are having a significant influence on the climate"are 
disingenuous, Hulme noted. The key scientific case for C0 2 driving global 
warming, like many others in the IPCC reports, "is reached by only a few 
dozen experts in the specific field of detection and attribution studies; other 
IPCC authors are experts in other fields." Other scientists are excluded or not 
consulted. 

Dr. William Schlesinger agrees with the UN climate view but has admitted that 

only 20% of UN IPCC scientists deal with climate . In other words, 80% of the 

UN's IPCC membership are experts in other fields and have no dealing with or 
expertise in climate change as part of their academic studies. 


This blog post appears in the 
FAQ section of the Climate 
ChangeTruth File section of 
the website of the Committee 
for a Constructive Tomorrow. 
(For another view on climate 
change, see Figure 6.3 on 
p. 1 26.) The questions below ask 
you to consider the guidelines 
for evaluating Internet sources 
(pp. 129-30). 

1 . This portion of the site is 
called "Climate ChangeTruth 
File." Does this title make 
you more likely or less likely 
to consider the information 
authoritative? 

2 . If you were considering 
using this source in a docu- 
ment you were writing, what 
information would you want 
to discover about the site 
and the organization that 
publishes it? How would you 
locate it? 

3 . The bulk of this passage is 
devoted to two prominent 
scientists who have changed 
their minds on the question 
of whether human-caused 
global warming is a serious 
threat. If the claim about the 
two scientists is true, does 
the case for human-caused 
global warming collapse? 


Source: Committee for a Constructive Tomorrow, 201 3: www.cfact.org/issues/climate-change/climate-change-truth-file/. 
Reprinted by permission of Committee for a Constructive Tomorrow, www.CFACT.org. 
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Businesses are spending the most time on social-media research, try- 
ing to figure out what customers like and dislike about their products and 
services, learn what they want, and reinforce brand loyalty Take the case of 
Nielsen, which for fifty years has been monitoring the TV viewing habits of 
Americans by distributing questionnaires and attaching devices to their TVs, 
and then selling the data it collects to TV networks and producers, who use 
the information to determine how much to charge advertisers. The problem 
at Nielsen is that many people don’t watch TV on TV or they don’t watch 
shows when they are broadcast. Now Nielsen also uses social-media analy- 
sis: gathering data by monitoring social media to listen in on what people are 
saying on TWitter, Facebook, and other services about different TV programs 
(DeVault, 2013). 

But organizations other than businesses are analyzing social-media data, 
too. For instance, the U.S. Geological Survey created the Twitter Earthquake 
Detector (TED), a program to monitor Twitter for the use of the word earth- 
quake. Why? Because they realized that when people experience earth- 
quakes, a lot of them tweet about it. The Centers for Disease Control, a U.S. 
federal agency, analyzes keywords on social media to monitor the spread 
of diseases, such as the H7N9 flu virus, in the United States and around 
the world. According to one scientist, “The world is equipped with human 
sensors — more than 7 billion and counting. It’s by far the most extensive 
sensor network on the planet. What can we learn by paying attention?” 
(McCaney, 2013). 

One more example: in 2008, an article in a medical journal suggested that 
lithium might slow down the progression of ALS, a condition sometimes called 
Lou Gehrig’s Disease. But the study reported on only a small number of patients 
with ALS. When other people with ALS heard about the article, they suggested 
gathering data from people with ALS across the country. Some 596 patients 
volunteered: some who were already using lithium, some who were not, and 
some who started using it (with the approval of their doctors). Although stud- 
ies such as this do not replace controlled double-blind experiments (in which 
neither the patients nor the researchers know whether the patients received 
the therapy), they are much faster and cheaper, and they can help researchers 
determine how to use their limited experimental resources wisely. According to 
the director of the ALS study, “sometimes the alternative is not our way or the 
old way. It is our way or it is not studied at all” (Marcus, 2011). 

How do you perform social-media data analysis? There are many soft- 
ware programs that can help you devise searches. Among the most popular 
is HootSuite, which includes tools for listening in on what people are saying 
about your company on social media such as TWitter, Facebook, Linkedln, and 
many other services. In addition, HootSuite helps you monitor and manage 
your company’s social-media presence and provides analytics: demographic 
data about who is following your company, their attitudes, and their behav- 
iors. Figure 6.6 shows a HootSuite dashboard, the screen that lets you view 
and manage all the information. 
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FIGURE 6.6 A HootSuite Dashboard 

Courtesy of HootSuite. 


OBSERVATIONS AND DEMONSTRATIONS 

Observation and demonstration are two common forms of primary research. 
When you observe, you simply watch some activity to understand some 
aspect of it. For instance, if you were trying to determine whether the loca- 
tion of the break room was interfering with work on the factory floor, you 
could observe the situation, preferably at different times of the day and on 
different days of the week. If you saw workers distracted by people moving 
in and out of the room or by sounds made in the room, you would record 
your observations by taking notes, taking photos, or shooting video of events. 
An observation might lead to other forms of primary research. You might, 
for example, follow up by interviewing some employees who could help you 
understand what you observed. 

When you witness a demonstration (or demo), you are watching someone 
carry out a process. For instance, if your company was considering buying 
a mail-sorting machine, you could arrange to visit a manufacturer’s facility, 
where technicians would show how the machine works. If your company 
was considering a portable machine, such as a laptop computer, manufactur- 
ers or dealers could demo their products at your facility. 


Like other similar tools for manag- 
ing social media, HootSuite enables 
you to keep your personal and busi- 
ness social media separate. Here we 
see a portion of a person's personal 
social-media feed. 

You set up"streams," which are 
filters that enable you to see only 
those tweets and other media that 
meet certain criteria. For instance, 
"News Feed" filters out everything 
that is not news. "News Feed — 
Photos" shows only news items that 
include photos. "Mentions" shows 
only those items in which you are 
mentioned. 
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When you plan to observe a situation or witness a demo, prepare before- 
hand. Write down the questions you need answered or the factors you want 
to investigate. Prepare interview questions in case you have a chance to 
speak with someone. Think about how you are going to incorporate the infor- 
mation you acquire into the document you will write. Finally, bring whatever 
equipment you will need (pen and paper, computer, camera, etc.) to the site 
of the observation or demo. 


INSPECTIONS 

Inspections are like observations, but you participate more actively. For exam- 
ple, a civil engineer can determine what caused a crack in a foundation by 
inspecting the site: walking around, looking at the crack, photographing it and 
the surrounding scene, examining the soil. An accountant can determine the 
financial health of an organization by inspecting its financial records, perhaps 
performing calculations and comparing the data she finds with other data. 

These professionals are applying their knowledge and professional judg- 
ment as they inspect a site, an object, or a document. Sometimes inspection 
techniques are more complicated. A civil engineer inspecting foundation 
cracking might want to test his hunches by bringing soil samples back to the 
lab for analysis. 

When you carry out an inspection, do your homework beforehand. Think 
about how you will use the data in your document: will you need photo- 
graphs or video files or computer data? Then prepare the materials and 
equipment you’ll need to capture the data. 


EXPERIMENTS 

Learning to conduct the many kinds of experiments used in a particular field 
can take months or even years. This discussion is a brief introduction. In 
many cases, conducting an experiment involves four phases. 


Establishing a 



hypothesis 

"*■ Testing the 



hypothesis 

Analyzing 


the data 


Reporting 
the data 


• Establishing a hypothesis. A hypothesis is an informed guess about the 
relationship between two factors. In a study relating gasoline octane and 
miles per gallon, a hypothesis might be that a car will get 5 percent better 
mileage with 89-octane gas than with 87-octane gas. 

• Testing the hypothesis. Usually, you need an experimental group and 
a control group. These two groups should be identical except for the 
condition you are studying: in the above example, the gasoline. The 
control group would be a car running on 87 octane. The experimental 
group would be an identical car running on 89 octane. The experiment 
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would consist of driving the two cars over an identical course at the same 
speed — preferably in some sort of controlled environment — over a given 
distance, such as 1,000 miles. Then you would calculate the miles per 
gallon. The results would either support or refute your original hypothesis. 

• Analyzing the data. Do your data show a correlation — one factor changing 
along with another — or a causal relationship? For example, we know that 
sports cars are involved in more fatal accidents than sedans (there is a 
stronger correlation for sports cars), but we don’t know what the causal 
relationship is — whether the car or the way it is driven is the important factor. 

• Reporting the data. When researchers report their findings, they explain 
what they did, why they did it, what they saw, what it means, and what 
ought to be done next. 

FIELD RESEARCH 

Whereas an experiment yields quantitative data that typically can be measured 
precisely, most field research is qualitative; that is, it yields data that typically 
cannot be measured precisely. Often in field research, you seek to understand 
the quality of an experience. For instance, you might want to understand how 
a new seating arrangement affects group dynamics in a classroom. You could 
design a study in which you observed and shot video of classes and interviewed 
the students and the instructor about their reactions to the new arrangement. 
Then you could do the same in a traditional classroom and compare the results. 

Some kinds of studies have both quantitative and qualitative elements. 

In the case of classroom seating arrangements, you could include some 
quantitative measures, such as the number of times students talked with 
one another. You could also distribute questionnaires to elicit ratings by the 
students and the instructor. If you used these same quantitative measures on 
enough classrooms, you could gather valid quantitative information. 

When you are doing quantitative or qualitative studies on the behavior 
of animals — from rats to monkeys to people — try to minimize two common 
problems: 

• The effect of the experiment on the behavior you are studying. In studying 
the effects of the classroom seating arrangement, minimize the effects of 
your own presence. For instance, if you observe in person, avoid drawing 
attention to yourself. Also, make sure that the video camera is placed 
unobtrusively and that it is set up before the students arrive, so they don’t 
see the process. Still, any time you bring in a camera, you cannot be sure 
that what you witness is typical. 

• Bias in the recording and analysis of the data. Bias can occur because 
researchers want to confirm their hypotheses. In an experiment to 
determine whether students write differently on physical keyboards than 
on touch screens, a researcher might see differences where other people 
don’t. For this reason, the experiment should be designed so that it is double 
blind. That is, the students shouldn’t know what the experiment is about so 
that they don’t change their behavior to support or negate the hypothesis, 


For more about reports, see 
Chs. 17-19. 
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and the data being analyzed should be disguised so that researchers don’t 
know whether they are examining the results from the control group or the 
experimental group. For example, the documents produced on keyboards 
and touch screens should be printed out the same way. 

Conducting an experiment or field research is relatively simple; the hard part 
is designing your study so that it accurately measures what you want it to 
measure. 


INTERVIEWS 

Interviews are extremely useful when you need information on subjects that 
are too new to have been discussed in the professional literature or are too 
narrow for widespread publication (such as local political questions). 

In choosing a respondent — a person to interview — answer three questions: 

• What questions do you want to answer? Only when you know this can you 
begin to search for a person who can provide the information. 

• Who could provide this information? The ideal respondent is an expert 
willing to talk. Unless there is an obvious choice, such as the professor 
carrying out the research you are studying, use directories, such as local 
industrial guides, to locate potential respondents. 

• Is the person willing to be interviewed? Contact the potential respondent by 
phone or in writing and state what you want to ask about. If the person is 
not able to help you, he or she might be willing to refer you to someone who 
can. Explain why you have decided to ask him or her. (A compliment works 
better than admitting that the person you really wanted to interview is out 
of town.) Explain what you plan to do with the information, such as write a 
report or present a talk. Then, if the person is willing to be interviewed, set 
up an appointment at his or her convenience. 


4 \ 


GUIDELINES 


Conducting an Interview 


PREPARING FOR THE INTERVIEW 


Follow these suggestions for preparing for and conducting an interview — and for 
following up after the interview. 


► Do your homework. If you ask questions that have already been answered in the 
professional literature, the respondent might become annoyed and uncooperative. 

► Prepare good questions. Good questions are clear, focused, and open. 

— Be clear. The respondent should be able to understand what you are asking. 
unclear Why do you sell Trane products? 

clear What are the characteristics of Trane products that led you to 

include them in your product line? 

The unclear question can be answered in a number of unhelpful ways:"Be- 
cause they're too expensive to give away" or "Because I'm a Trane dealer." 


( continued ) 





Conducting Primary Research 


6 


137 


— Be focused. The question must be narrow enough to be answered briefly. If 
you want more information, you can ask a follow-up question. 
unfocused What is the future of the computer industry? 

focused What will the American chip industry look like in 1 0 years? 

— Ask open questions. Your purpose is to get the respondent to talk. Don't ask a 
lot of questions that have yes or no answers. 

closed Do you think the federal government should create industrial 

partnerships? 

open What are the advantages and disadvantages of the federal gov- 

ernment's creating industrial partnerships? 

► Check your equipment. If you will be recording the interview, test your voice 
recorder or video camera to make sure it is operating properly. 

BEGINNING THE INTERVIEW 

► Arrive on time. 

► Thank the respondent for taking the time to talk with you. 

► State the subject and purpose of the interview and what you plan to do with 
the information. 

► If you wish to record the interview, ask permission. 

CONDUCTING THE INTERVIEW 

► Take notes. Write down important concepts, facts, and numbers, but don't take 
such copious notes that you can't make eye contact with the respondent or that 
you are still writing when the respondent finishes an answer. 

► Start with prepared questions. Because you are likely to be nervous at the 
start, you might forget important questions. Have your first few questions 
ready. 

► Be prepared to ask follow-up questions. Listen carefully to the respondent's 
answer and be ready to ask a follow-up question or request a clarification. Have 
your other prepared questions ready, but be willing to deviate from them if the 
respondent leads you in unexpected directions. 

► Be prepared to get the interview back on track. Gently return to the point if the 
respondent begins straying unproductively, but don't interrupt rudely or show 
annoyance. Do not say, "Whoa! I asked about layoffs in this company, not in the 
whole industry." Rather, say, "On the question of layoffs at this company, do you 
anticipate . . . ?" 

CONCLUDING THE INTERVIEW 

► Thank the respondent. 

► Ask for a follow-up interview. If a second meeting would be useful, ask to ar- 
range one. 

► Ask for permission to quote the respondent. If you think you might want to 
quote the respondent by name, ask for permission now. 


( continued ) 
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For more about inquiry letters, see 
Ch. 14, p. 367. 


To find software for conducting 
surveys, search for "survey software." 


AFTER THE INTERVIEW 

► Write down the important information while the interview is fresh in your 
mind. (This step is unnecessary, of course, if you have recorded the interview.) If 
you will be printing a transcript of the interview, make the transcript now. 

► Send a brief thank-you note. Within a day or two, send a note showing that you 
appreciate the respondent's courtesy and that you value what you have learned. 
In the note, confirm any previous offers you have made, such as to send the 
respondent a copy of your final document. 


When you wish to present the data from an interview in a document you 
are preparing, include a transcript of the interview (or an excerpt from the 
interview). You will probably present the transcript as an appendix so that 
readers can refer to it but are not slowed down when reading the body of the 
document. You might decide to present brief excerpts from the transcript in 
the body of the document as evidence for points you make. 

Figure 6.7 is from a transcript of an interview with an attorney specializing 
in information technology. The interviewer is a student who is writing about 
legal aspects of software ownership. 

INQUIRIES 

A useful alternative to a personal interview is to send an inquiry. This inquiry 
can take the form of a letter, an email, or a message sent through an organi- 
zation’s website. Although digital inquiries are more convenient for both the 
sender and the recipient, a physical letter is more formal and therefore might 
be more appropriate if the topic is important (concerning personnel layoffs, 
for instance) or related to safety. 

If you are lucky, your respondent will provide detailed and helpful 
answers. However, the respondent might not clearly understand what you 
want to know or might choose not to help you. Although the strategy of the 
inquiry is essentially that of a personal interview, inquiries can be less suc- 
cessful because the recipient has not already agreed to provide information 
and might not respond. Also, an inquiry, unlike an interview, gives you little 
opportunity to follow up by asking for clarification. 

QUESTIONNAIRES 

Questionnaires enable you to solicit information from a large group of peo- 
ple. You can send questionnaires through the mail, email them, present them 
as forms on a website, or use survey software (such as SurveyMonkey). 

Unfortunately, questionnaires rarely yield completely satisfactory results, 
for three reasons: 

• Some of the questions will misfire. Respondents will misinterpret some of 
your questions or supply useless answers. 
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Interview Transcript, Page 1 

Q. Why is copyright ownership important in marketing software? 

A. If you own the copyright, you can license and market the product and keep other people 
from doing so. It could be a matter of millions of dollars if the software is popular. 

Q. Shouldn’t the programmer automatically own the copyright? 

A. If the programmer wrote the program on personal time, he or she should and does own 
the copyright. 

Q. So “personal time” is the critical concept? 

A. That’s right. We’re talking about the “work-made-for-hire” doctrine of copyright law. If 
I am working for you, anything I make under the terms of my employment is owned by 
you. 

Q. What is the complication, then? If I make the software on my machine at home, I own it; 
if I’m working for someone, my employer owns it. 

A. Well, the devil is in the details. Often the terms of employment are casual, or there is no 
written job description or contract for the particular piece of software. 

Q. Can you give me an example of that? 

A. Sure. There was a 1992 case, Aymes v. Bonelli. Bonelli owned a swimming pool and 
hired Aymes to write software to handle record keeping on the pool. This was not part 
of Bonelli’s regular business; he just wanted a piece of software written. The terms of the 
employment were casual. Bonelli paid no health benefits, Aymes worked irregular hours, 
usually unsupervised — Bonelli wasn’t a programmer. When the case was heard, the court 
ruled that even though Bonelli was paying Aymes, Aymes owned the copyright because of 
the lack of involvement and participation by Bonelli. The court found that the degree of 
skill required by Aymes to do the job was so great that, in effect, he was creating the 
software by himself, even though he was receiving compensation for it. 

Q. How can such disagreements be prevented? By working out the details ahead of time? 

A. Exactly. The employer should have the employee sign a statement that the project is 
being carried out as work made for hire and should register the copyright with the U.S. 
Copyright Office in Washington. Conversely, employees should try to have the employer 
sign a statement that the project is not work made for hire and should try to register the 
copyright themselves. 

Q. And if agreement can’t be reached ahead of time? 

A. Then stop right there. Don’t do any work. 


FIGURE 6.7 Excerpt 
from an Interview 


The student prompts the attorney 
to expand her answers. 


The student responds to the attor- 
ney's answers, making the interview 
more of a discussion. 


• You won't obtain as many responses as you want. The response rate will 
almost never exceed 50 percent. In most cases, it will be closer to 10 to 
20 percent. 

• You cannot be sure the respondents are representative. People who feel 
strongly about an issue are much more likely to respond to questionnaires 
than are those who do not. For this reason, you need to be careful 

in drawing conclusions based on a small number of responses to a 
questionnaire. 
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When you send a questionnaire, you are asking the recipient to do you a 
favor. Your goal should be to construct questions that will elicit the informa- 
tion you need as simply and efficiently as possible. 

Asking Effective Questions To ask effective questions, follow two sug- 
gestions: 

• Use unbiased language. Don’t ask, “Should U.S. clothing manufacturers 
protect themselves from unfair foreign competition?” Instead, ask, “Are 
you in favor of imposing tariffs on men’s clothing?” 

• Be specific. If you ask, “Do you favor improving the safety of automobiles?” 
only an eccentric would answer no. Instead, ask, “Do you favor requiring 
automobile manufacturers to equip new cars with electronic stability 
control, which would raise the price by an average of $300 per car?” 

Table 6.2 explains common types of questions used in questionnaires. 

Include an introductory explanation with the questionnaire. This expla- 
nation should clearly indicate who you are, why you are writing, what you 
plan to do with the information from the questionnaire, and when you will 
need it. 


1 TABLE 6.2 Common Types of Questions Used in Questionnaires 




TYPE OF QUESTION 

EXAMPLE 

COMMENTS 

Multiple choice 

Would you consider joining a company- 
sponsored sports team? Yes No 

The respondent selects one of the alternatives. 

Likert scale 

The flextime program has been a success in its 
first year. 

stronalv disaaree stronalv aaree 

The respondent ranks the degree to which he or she 
agrees or disagrees with the statement. Using an 
even number of possible responses (six, in this case) 
increases your chances of obtaining useful data. 
With an odd number, many respondents will choose 
the middle response. 

Semantic differentials 

Logging on to the system 
simple difficult 

The description of the new desalinization 
process 

interestina borina 

The respondent registers a response along a 
continuum between a pair of opposing adjectives. 
Usually, these questions measure a person's feelings 
about a task, an experience, or an object. As with 
Likert scales, an even number of possible responses 
yields better data. 

Ranking 

Please rank the following work schedules in 
order of preference. Put a 1 next to the schedule 
you would most like to have, a 2 next to your 
second choice, and so on. 

8:00-4:30 

9:00-5:30 

8:30-5:00 

flexible 

The respondent indicates the priority of a number of 
alternatives. 


( continued ) 
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TABLE 6.2 Common Types of Questions Used in Questionnaires (continued) 


TYPE OF QUESTION EXAMPLE COMMENTS 

Short answer What do you feel are the major advantages of The respondent writes a brief answer using phrases 

the new parts-requisitioning policy? or sentences. 

1 . 

2. 

3. 


Short essay 


The new parts-requisitioning policy has been 
in effect for a year. How well do you think it is 
working? 


Although essay questions can yield information 
you never would have found using closed-ended 
questions, you will receive fewer responses to them 
because answering them requires more effort. Also, 
essays cannot be quantified precisely, as data from 
other types of questions can. 


Testing the Questionnaire Before you send out any questionnaire, show For more about testing documents, 

it and its accompanying explanation to a few people who can help you iden- seeCh. 1 3, p.348. 

tify any problems. After you have revised the materials, test them on people 

whose backgrounds are similar to those of your intended respondents. Revise 

the materials a second time, and, if possible, test them again. Once you have 

sent the questionnaire, you cannot revise it and resend it to the same people. 

Administering the Questionnaire Determining who should receive the 
questionnaire can be simple or difficult. If you want to know what the resi- 
dents of a particular street think about a proposed construction project, your 
job is easy. But if you want to know what mechanical-engineering students 
in colleges across the country think about their curricula, you will need a 
background in sampling techniques to identify a representative sample. 

Make it easy for respondents to present their information. For mailed 
questionnaires, include a self-addressed, stamped envelope. 

Figure 6.8 on page 142 shows a sample questionnaire. 

Presenting Questionnaire Data in Your Document To decide where 
and how to present the data that you acquire from your questionnaire, 
think about your audience and purpose. Start with this principle: important 
information is presented and analyzed in the body of a document, whereas 
less-important information is presented in an appendix (a section at the end 
that only some of your audience will read). Most often, different versions of 
the same information appear in both places. 
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FIGURE 6.8 

Questionnaire 


Likert-scale questions 3 and 4 make 
it easy for the writer to quantify 
data about subjective impressions. 


Short-answer questions 6 and 7 
are best for soliciting ideas from 
respondents. 


September 6, 2015 
To: All employees 

From: William Bonoff, Vice President of Operations 

Subject: Evaluation of the Lunches Unlimited food service 

As you may know, every two years we evaluate the quality and cost of the food 
service that caters our lunchroom. We would like you to help in our evaluation by 
sharing your opinions about the food service. Please note that your responses will 
remain anonymous. Please drop the completed questionnaires in the marked boxes 
near the main entrance to the lunchroom. 

1 . Approximately how many days per week do you eat lunch in the lunchroom? 

0 1_ 2 3 4 5 

2. At approximately what time do you eat in the lunchroom? 

11:30-12:30 12:00-1:00 12:30-1:30 varies 

3. A clean table is usually available. 

strongly disagree strongly agree 

4. The Lunches Unlimited personnel are polite and helpful. 

strongly disagree strongly agree 

5. Please comment on the quality of the different kinds of food you have eaten 
in the lunchroom. 


Daily specials 
excellent 

good 

satisfactorv 

poor 

Hot dogs and hamburgers 



excellent 

good 

satisfactorv 

poor 

Other entrees 
excellent 

good 

satisfactory 

poor 


6. What foods would you like to see served that are not served now? 


7. What beverages would you like to see served that are not served now? 


8. Please comment on the prices of the foods and beverages served. 

a. Hot meals (daily specials) 

too high fair a bargain 

b. Hot dogs and hamburgers 

too high fair a bargain 

c. Other entrees 

too high fair a bargain 

9. Would you be willing to spend more money for a better-quality lunch if you 
thought the price was reasonable? 

yes, often sometimes not likely 

10. On the other side of this sheet, please provide whatever comments you think 
will help us evaluate the catering service. 


Thank you for your assistance. 
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Typically, the full questionnaire data are presented in an appendix. If you 
can, present the respondents’ data — the answers they provided — in the ques- 
tionnaire itself, as shown here: 


1 . Approximately how many days per week do you eat lunch in the lunchroom? 

012 116 218 3 12 49 54 

2. At approximately what time do you eat in the lunchroom? 

11:30-12:30 3 12:00-1:00 26 12:30-1:30 Z varies 23 

Selected data might then be interpreted in the body of the document. For 
instance, you might devote a few sentences or paragraphs to the data for one 
of the questions. The following example shows how a writer might discuss 
the data from question 2. 


If you thinkyour reader will benefit 
from analyses of the data, present 
such analyses. For instance, you 
could calculate the percentage for 
each response: for question 1 , "1 2 
people — 1 7 percent — say they do 
not eat in the cafeteria at a 1 1 ." 0 r 
you could present the percentage 
in parentheses after each number: 
"12(17%)." 


Question 2 shows that 26 people say that they use the cafeteria between noon and 
1 :00. Only 1 0 people selected the two other times: 1 1 :30-1 2:30 or 1 2:30-1 :30. Of the 
23 people who said they use the cafeteria at various times, we can conclude that at 
least a third — 8 people — use it between noon and 1 :00. If this assumption is correct, at 
least 34 people (26 + 8) use the cafeteria between noon and 1 :00.This would explain 
why people routinely cannot find a table in the noon hour, especially between 1 2:1 5 
and 1 2:30. To alleviate this problem, we might consider asking department heads not 
to schedule meetings between 1 1 :30 and 1 :30, to make it easier for their people to 
choose one of the less-popular times. 


The body of a document is also a good place to discuss important nonquan- 
titative data. For example, you might wish to discuss and interpret several 
representative textual answers to open-ended questions. 


ETHICS NOTE 


REPORTING AND ANALYZING DATA HONESTLY 

When you put a lot of time and effort into a research project, it's frustrating if you can't find the 
information you need or if the information you find doesn't help you say what you want to say. 
As discussed in Chapter 2, your responsibility as a professional is to tell the truth. 

If the evidence suggests that the course of action you propose won't work, don't omit that evi- 
dence or change it. Rather, try to figure out why the evidence does not support your proposal. 
Present your explanation honestly. 

If you can't find reputable evidence to support your claim that one device works better than 
another, don't just keep silent and hope your readers won't notice. Explain why you think the 
evidence is missing and how you propose to follow up by continuing your research. 

If you make an honest mistake, you are a person. If you cover up a mistake, you're a dishonest 
person. If you get caught fudging the data, you could be an unemployed dishonest person. If 
you don't get caught, you're still a smaller person. 
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RESEARCHING YOUR SUBJECT 


WRITER'S CHECKLIST 


EH Did you determine the questions you need to answer for 
your document? (p. 7 17) 

Did you choose appropriate secondary-research tools to 
answer those questions, including, if appropriate, 

EH online catalogs? (p. 121) 

EH reference works? (p. 12 1) 

EH periodical indexes? (p. 122) 

□ newspaper indexes? (p. 122) 

LH abstract services? (p. 123) 

EH government information? (p. 123) 

EH social media and other interactive resources? (p. 124) 

In evaluating information, did you carefully assess 
EH the author's credentials? (p. 129) 

I the publisher? (p. 129) 

EH the author's knowledge of literature in the field? (p. 130) 


EH the accuracy and verifiability of the information? (p. 130) 
EH the timeliness of the information? (p. 130) 

Did you choose appropriate primary-research methods to 
answer your questions, including, if appropriate, 

EH social-media data analysis? (p. 130) 

EH observations and demonstrations? (p. 133) 

I inspections? (p. 134) 

LH experiments? (p. 134) 

EH field research? (p. 135) 

I interviews? (p. 136) 

I inquiries? (p. 138) 

I questionnaires? (p. 138) 

EH Did you report and analyze the data honestly? (p. 143) 


EXERCISES 


For more about memos, see Ch. 14, p. 372. 

1. Imagine you are an executive working fora company 
that distributes books to bookstores in the Seattle, 
Washington, area. Your company, with a 20,000-square- 
foot warehouse and a fleet of 15 small delivery vans, 
employs 75 people. The following are three questions 
that an academic researcher specializing in energy 
issues might focus on in her research. Translate each of 
these academic questions into a workplace question 
that your company might need to answer. 

a. What are the principal problems that need to be 
resolved before biomass (such as switchgrass) can 
become a viable energy source for cars and trucks? 

b. How much money will need to be invested in the 
transmission grid before windmills can become a 
major part of the energy solution for business and 
residential customers in the western United States? 

c. Would a federal program that enables companies to 
buy and sell carbon offsets help or hurt industry in 
the United States? 

2 . For each of the following questions, select a research 
technique that is likely to yield a useful answer. For 


instance, if the question is "Which companies within 
a 20-mile radius of our company headquarters sell 
recycled paper?"a search of the web is likely to provide 
a useful answer. 

a. Does the Honda CR-V include traction control as a 
standard feature? 

b. How much money has our company's philanthropic 
foundation donated to colleges and universities in 
each of the last three years? 

c. How does a 3D printer work? 

d. Could our Building 3 support a rooftop green space? 

e. How can we determine whether we would save 
more money by switching to LED lighting in our 
corporate offices? 

3 . Using a search engine, answer the following questions. 
Provide the URL of each site that provides information 
for your answer. If your instructor requests it, submit 
your answers in an email to him or her. 
a. What are the three largest or most important 
professional organizations in your field? (For 
example, if you are a construction management 
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major, your field is construction management, civil 
engineering, or industrial engineering.) 

b. What are three important journals read by people in 
your field? 

c. What are three important online discussion lists or 
bulletin boards read by people in your field? 

d. What are the date and location of an upcoming 
national or international professional meeting for 
people in your field? 

e. Name and describe, in one paragraph for each, three 
major issues being discussed by practitioners or 
academics in your field. For instance, nurses might 
be discussing the effect of managed care on the 
quality of medical care delivered to patients. 

4 . Revise the following interview questions to make them 
more effective. In a brief paragraph for each, explain 
why you have revised the question as you have. 

a. What is the role of communication in your daily job? 

b. Do you think it is better to relocate your warehouse 
or go to just-in-time manufacturing? 

c. Isn't it true that it's almost impossible to train an 
engineer to write well? 

d. Where are your company's headquarters? 

e. Is there anything else you think I should know? 

5 . Revise the following questions from questionnaires to 
make them more effective. In a brief paragraph for each, 
explain why you have revised the question as you have, 

a. Does your company provide tuition reimbursement 

for its employees? Yes No 


b. What do you see as the future of bioengineering? 

c. How satisfied are you with the computer support 
you receive? 

d. How many employees work at your company? 

5-1 0 1 0-1 5 1 5 or more 

e. What kinds of documents do you write most often? 

memos letters reports 

6. TEAM EXERCISE Form small groups, and describe and 
evaluate your college or university's website. A different 
member of the group might carryout each of the 
following tasks: 

• In an email to the site's webmaster, ask questions 
about the process of creating the site. For example, 
how involved was the webmaster with the content 
and design of the site? What is the webmaster's role 
in maintaining the site? 

• Analyze the kinds of information the site contains, 
and determine whether the site is intended 
primarily for faculty, students, alumni, legislators, or 
prospective students. 

• Determine the overlap between information on the 
site and information in printed documents published 
by the school. In those cases in which there is 
overlap, is the information on the site merely a 
duplication of the printed information, or has it been 
revised to take advantage of the unique capabilities 
of the web? 

In a memo to your instructor, present your findings and 
recommend ways to improve the site. 


For more practice with the concepts covered in this chapter, 
complete the LearningCurve activity "Researching Your Subject" 
under "Additional Resources" in Ch. 6: macmillanhighered.com 
/launchpad/techcommlle. 


CASE 6: Revising a Questionnaire 



You're a marketing director at a real-estate company who is trying to determine whether it 
would be cost-effective to have the company's agents take property photos instead of having 
the photos taken by the professional photographers from the supplier with which you currently 
contract. You ask one of your agents to develop a questionnaire to gauge agents' reactions to 
and opinions about the possibility of adding photography to their responsibilities, but you find 
that her questionnaire needs considerable revising before it will bean effective tool. To access 
the questionnaire and begin assessing it, go to"Cases"under"Additional Resources"in Ch. 6: 
macmillanhighered.com/launchpad/techcomm1 1 e. 






Organizing Your 
Information 


Understanding Three Principles for Organizing 
Technical Information 147 

ANALYZING YOUR AUDIENCE AND PURPOSE 147 

USING CONVENTIONAL PATTERNS OF ORGANIZATION 148 

DISPLAYING YOUR ORGANIZATIONAL PATTERN PROMINENTLY 149 

Understanding Conventional Organizational Patterns 149 

CHRONOLOGICAL 151 

a GUIDELINES: Organizing Information Chronologically 151 

SPATIAL 153 

a GUIDELINES: Organizing Information Spatially 153 

GENERAL TO SPECIFIC 154 

a GUIDELINES: Organizing Information from General to Specific 154 
MORE IMPORTANTTO LESS IMPORTANT 154 

a GUIDELINES: Organizing Information from More Important to Less Important 

COMPARISON AND CONTRAST 156 

a GUIDELINES: Organizing Information by Comparison and Contrast 158 
a ETHICS NOTE: Comparing and Contrasting Fairly 158 
CLASSIFICATION OR PARTITION 158 

a GUIDELINES: Organizing Information by Classification or Partition 160 
PROBLEM-METHODS-SOLUTION 1 60 

a GUIDELINES: Organizing Information by Problem-Methods-Solution 1 62 
CAUSE AND EFFECT 163 

a GUIDELINES: Organizing Information by Cause and Effect 165 


■ DOCUMENT ANALYSIS ACTIVITY: Using Multiple Organizational Patterns in an 
Infographic 166 


WRITER'S CHECKLIST 167 
EXERCISES 168 

LEARNINGCURVE: Orga nizing and Emphasizing Your Information 168 and 
CASE 7: Organizing a Document for Clarity — and Diplomacy 168 and 


DURING THE PLANNING PHASE of your writing process, you need to organize 
the information that will go into a document. Writers draw on a number of 
structures, or organizational patterns, to deliver information to their audiences. 
But how do you know which organizational patterns will work best for a given 
project? Is it a question of the information you want to communicate? The 
audience you are addressing? The purpose you are trying to achieve? The culture 
in your own company? Short answer: to varying degrees, all of these factors will 
influence the pattern you choose. To get some ideas, talk with experienced co- 
workers, study other similar documents, and read this chapter. 

At this point, you should know for whom you are writing and why, and you 
should have completed most of your research. Now it is time to start organizing 
the information that will make up the body of your document, whether it is a 
print document or an online one. 


Understanding Three Principles 
for Organizing Technical Information 

In organizing your information, analyze your audience and purpose, use con- 
ventional patterns of organization, and display your organizational pattern 
prominently. 

As with any important writing task, you might want to discuss your ideas 
about how to organize the document with others in your network. They 
might identify other factors that you should consider or suggest other pat- 
terns of organization that might work better for your audience, purpose, and 
subject. 

ANALYZING YOUR AUDIENCE AND PURPOSE 

Although you thought about your audience and purpose as you planned and 
researched your subject, your analyses of audience and purpose are likely to 
change as you continue. Therefore, it is useful to review your initial assess- 
ment of audience and purpose before you proceed. 

Will your audience like the message you will present? If so, announce your 
main point early in the document. If not, consider a pattern that presents 
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For more about audience and 
purpose, see Ch. 5. 


your important evidence before your main point. Is your audience used to 
seeing a particular pattern in the application (the kind of document you will 
be writing)? If they are, you will probably want to use that pattern, unless you 
have a good reason to use a different one. 

What is your purpose in writing the document? Do you want your audi- 
ence to understand a body of information or to accept a point of view and 
perhaps act on it? One purpose might call for a brief report without any 
appendixes; the other might require a detailed report, complete with 
appendixes. 

If you are addressing people from other cultures, remember that organiza- 
tional patterns can vary from culture to culture. If you can, study documents 
written by people from the culture you are addressing to see whether they 
favor an organizational pattern different from the one you are considering. 

As you do so, ask yourself the following four questions: 

• Does the document follow expected organizational patterns? For example, 
this chapter discusses the general-to-specific pattern. Does the document 
you are studying present the specific information first? 

• Do the introduction and conclusion present the kind of information you 
would expect? In the United States, main findings are often presented 
in the introduction; in some other cultures, the main findings are not 
presented until late in the document. 

• Does the document appear to be organized linearly? Is the main idea 
presented first in a topic sentence or thesis statement? Does supporting 
information follow? In some cultures, main ideas are withheld until the 
end of the paragraph or document. 

• Does the document use headings? If so, does it use more than one level? 

If documents from the culture you plan to address are organized very 
differently from those you’re used to seeing, take extra steps to ensure 
that you don’t distract readers by using an unfamiliar organizational 
pattern. 

USING CONVENTIONAL PATTERNS OF ORGANIZATION 

This chapter presents a number of conventional, or commonly used, patterns 
of organization, such as the chronological pattern and the spatial pattern. 

You should begin by asking yourself whether a conventional pattern for pre- 
senting your information already exists. Using a conventional pattern makes 
things easier for you as a writer and for your audience. 

For you, a conventional pattern serves as a template or checklist, helping 
you remember which information to include and where to put it. In a pro- 
posal, for example, you include a budget, which you put near the end or in an 
appendix. For your audience, a conventional pattern makes your document 
easier to read and understand. Readers who are familiar with proposals can 
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find the information they want because you have put it where others have 
put similar information. 

Does this mean that technical communication is merely a process of fill- 
ing in the blanks? No. You need to assess the writing situation continuously 
as you work. If you think you can communicate your ideas better by modify- 
ing a conventional pattern or by devising a new pattern, do so. However, you 
gain nothing if an existing pattern would work just as well. 


DISPLAYING YOUR ORGANIZATIONAL PATTERN PROMINENTLY 

Make it easy for your readers to understand your organizational pattern. Dis- 
playing your pattern prominently involves three main steps: 

• Create a detailed table of contents. If your document has a table of 
contents, including at least two levels of headings helps readers find the 
information they seek. 

• Use headings liberally. Headings break up the text, making your pages 
more interesting visually. They also communicate the subject of the 
section and improve readers’ understanding. 

• Use topic sentences at the beginnings of your paragraphs. The topic 
sentence announces the main point of a paragraph and helps the reader 
understand the details that follow. 


For more about tables of contents, 
seeCh. 18, p. 480. For more about 
headings and topic sentences, see 
Ch.9,pp. 194 and 205. 


Understanding Conventional 
Organizational Patterns 

Every argument calls for its own organizational pattern. Table 7.1 explains 
the relationship between organizational patterns and the kinds of informa- 
tion you want to present. 


TABLE 7.1 Organizational Patterns and the Kinds of Information You Want To Present 


IF YOU WANT TO... 

CONSIDER USING THIS 
ORGANIZATIONAL PATTERN 

FOR EXAMPLE... 

Explain events that occurred or might 
occur or tasks that the reader is to carry 
out 

Chronological (p. 151). Most of the time, 
you present information in chronological 
order. Sometimes, however, you use 
reverse chronology. 

You describe the process used to 
diagnose the problem with the 
accounting software. Or, in a resume, you 
describe your more-recent jobs before 
your earlier ones. 

Describe a physical object or scene, such 
as a device or a location 

Spatial (p. 1 53). You choose an 
organizing principle such as top-to- 
bottom, east-to-west, or inside-to- 
outside. 

You describe the three main buildings 
that will make up the new production 
facility. 


( continued ) 
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TABLE 7.1 Organizational Patterns and the Kinds of Information You Want To Present ( continued ) 


IF YOU WANT TO... 

CONSIDER USING THIS 
ORGANIZATIONAL PATTERN 

FOR EXAMPLE... 

Explain a complex situation, such as 
the factors that led to a problem or the 
theory that underlies a process 

General to specific (p. 1 54). You present 
general information first, then specific 
information. Understanding the big 
picture helps readers understand the 
details. 

You explain the major changes and the 
details of a law mandating the use of a 
new refrigerant in cooling systems. 

Present a set of factors 

More important to less important 

(p. 154). You discuss the most-important 
issue first, then the next-most-important 
issue, and so forth. In technical 
communication, you don't want to 
create suspense. You want to present the 
most-important information first. 

When you launch a new product, you 
discuss market niche, competition, and 
then pricing. 

Present similarities and differences 
between two or more items 

Comparison and contrast (p. 1 56). You 
choose from one of two patterns: (1 ) 
discuss all the factors related to one item, 
then all the factors related to the next 
item, and so forth; (2) discuss one factor 
as it relates to all the items, then another 
factor as it relates to all the items, and so 
forth. 

You discuss the strengths and 
weaknesses of three companies bidding 
on a contract your company is offering. 
You discuss everything about Company 
1 , then everything about Company 2, 
and then everything about Company 
3. Or you discuss the management 
structure of Company 1, of Company 2, 
and of Company 3; then you address the 
engineering expertise of Company 1, of 
Company 2, and of Company 3; and so 
forth. 

Assign items to logical categories or 
discuss the elements that make up a 
single item 

Classification or partition (p. 1 58). 
Classification involves placing items into 
categories according to some criterion. 
Partition involves breaking a single item 
or a group of items into major elements. 

For classification, you group the motors 
your company manufactures according 
to the fuel they burn: gasoline or diesel. 
For partition, you explain the operation 
of each major component of one of your 
motors. 

Discuss a problem you encountered, the 
steps you took to address the problem, 
and the outcome or solution 

Problem-methods-solution (p. 160). You 
can use this pattern in discussing the 
past, the present, or the future. Readers 
understand this organizational pattern 
because they use it in their everyday 
lives. 

In describing how your company is 
responding to a new competitor, you 
discuss the problem (the recent loss 
in sales), the methods (how you plan 
to examine your product line and 
business practices), and the solution 
(which changes will help your company 
prosper). 

Discuss the factors that led to (or will 
lead to) a given situation, or the effects 
that a situation led to or will lead to 

Cause and effect (p. 1 63). You can start 
from causes and speculate about effects, 
or you can start with the effect and try to 
determine which factors were the causes 
of that effect. 

You discuss factors that you think 
contributed to a recent sales dip for one 
of your products. Or you explain how 
you think changes to an existing product 
will affect its future sales. 
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CONTENTS 

Chapter 1: Setting Up Your Susamu Tablet • 

9 Opening the Box • . 

Different sections of this manual use 
different organizational patterns. 

Chapter 1 is organized chronologi- 
cally. you take the product out of 
the box before you set it up and run 
it and before you shut it down. 

9 Setting Up Your Susamu Tablet 
15 Shutting Down Your Susamu Tablet 

Chapter 2: Using Your Susamu Tablet • 

20 Basic Features of the Susamu Tablet 
22 Using the Touch Screen Keyboard 
26 Using the Ports on the Susamu Tablet 
29 Using the Susamu Tablet Battery 

Chapter 3: If You Have Problems • 

In Chapter 1 , the section called 
"Opening the Box" uses partition 
by showing and naming the vari- 
ous items that are included in the 
package. 

Chapter 2 is organized from general 
to specific : you want to understand 
the basic features of the product 
before you study the more special- 
ized features. 

34 Troubleshooting Tips 


39 Finding Other Resources 

Chapter 3 is organized according 
to the problem-methods-solution 

43 Contacting Susamu 

pattern. The reader tries to solve 


the problem by reading the 


troubleshooting tips, locating 


other resources, and contacting the 

FIGURE 7.1 Using Multiple Organizational Patterns in a Single Document manufacturer 


Long, complex arguments often require several organizational patterns. 
For instance, one part of a document might be a causal analysis of the prob- 
lem you are writing about, and another might be a comparison and contrast 
of two options for solving that problem. Figure 7.1, an excerpt from a user’s 
manual, shows how different patterns might be used in a single document. 

CHRONOLOGICAL 

The chronological — or timeline — pattern is commonly used to describe 
events. In an accident report, you describe the events in the order in which 
they occurred. In the background section of a report, you describe the events 
that led to the present situation. In a set of slides for an oral presentation, you 
explain the role of social media in U.S. presidential elections by discussing 
each of the presidential elections, in order, since 2000. 


A 


GUIDELINES 


Organizing Information Chronologically 


These three suggestions can help you write an effective chronological passage. 


► Provide signposts. If the passage is more than a few hundred words long, use 
headings. Choose words such as step, phase, stage, and part, and consider num- 
bering them. Add descriptive phrases to focus readers' attention on the topic of 
the section: 


For more about transitions, see 
Ch. 9, p. 209. 


( continued ) 
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For more about graphics, see Ch. 1 2. 


Phase One: Determining Our Objectives 
Step 3: Installing the Lateral Supports 

At the paragraph and sentence levels, transitional words such as then, next, first, 
and finally will help your reader follow your discussion. 

► Consider using graphics to complement the text. Flowcharts, in particular, help 
you emphasize chronological passages for all kinds of readers, from the most 
expert to the general reader. 

► Analyze events where appropriate. When you use chronology, you are explain- 
ing what happened in what sequence, but you are not necessarily explaining 
why or how an event occurred or what it means. For instance, the largest section 
of an accident report is usually devoted to the chronological discussion, but the 
report is of little value unless it explains what caused the accident, who bears 
responsibility, and how such accidents can be prevented. 


Figure 7.2, a timeline presented on the University of Washington’s website, 
is organized chronologically. 

SPATIAL 

The spatial pattern is commonly used to describe objects and physical sites. In an 
accident report, you describe the physical scene of the accident. In a feasibility study 
about building a facility, you describe the property on which it would be built. In a 
proposal to design a new microchip, you describe the layout of the new chip. 

Figure 7.3 shows the use of spatial organization. 


FIGURE 7.2 Infor- 
mation Organized 
Chronologically 

From www.washington.edu/2y2d 
/about-2y2d/timeline/. Reprinted by 
permission. 


The university wishes to organize its 
academic initiative chronologically: 
in terms of academic-year periods. 
Therefore, it makes sense to use a 
timeline with a list of the activities 
that will occur in each period. The 
different color for each period 
further emphasizes the role of 
chronology. 


2009-2010 


2010-2011 


• Gathered input 
"Where do you see the 
UW in 20 years?" 

• Formed a leadership 
team 

• Synthesized input 
"UW of the 21** C* 


Developed: Strategic 
Framework 

Launched and 
implemented 
initiatives: 

Teaching & Learning 
Collaboration 
Organizational 
Effectiveness 

Gathered more input: 
which of society's 
issues the U W can he Ip 
address 

Synthesized input sx 
two-decade (2d) areas 
of focus 


2011-2012 



2012-2013 



Refined: Strategic 
Framework 

Implemented ongoing 
initiatives 

Delivered: Resources, 
tools, andservicesto 
the campus community 

Launched and 
implemented new 

initiatives: 


Goals /Next Steps: 

• Support teaching & 
learning innovation. 

• Decrease 
administrative burden 
to faculty. 

• Support "flipping the 
classroom" 
experimentation & 
pilots. 


Campusof the 2l” 
Century & Enhancing 
Student Services 


Improve classroom 
space and 
infrastructure. 


Conducted pilots. 

Gathered and shared 
examples of campus 
efforts algned to 
strategic framework. 


Expand complex grant 
proposal support. 

Enable faculty 
collaborations. 


Help more units save 
money and improve 
service. 


W 
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GUIDELINES 


Organizing Information Spatially 


These three suggestions can help you write an effective spatial passage. 


► Provide signposts. Help your readers follow the argument by using words and 
phrases that indicate location (to the left, above, in the center) in headings, topic 
sentences, and support sentences. 

► Consider using graphics to complement the text. Diagrams, drawings, photo- 
graphs, and maps clarify spatial relationships. 

► Analyze events where appropriate. A spatial arrangement doesn't explain itself; 
you have to do the analysis. A diagram of a floor plan cannot explain why the 
floor plan is effective or ineffective. 


Recommended Levels of Insulation 

insulation level are specified by R-vaiue R-Vaiue Is a measure of insulation s ability to resist heat traveling through ft The higher the R-vatue the better the thermal 
performance of the insulation. The table below shows what levels of Insulation are cost-effective for afferent climates and locations in the home. 


1 



Recommended insulation levels for 


retrofitting existing wood-framed buildings 


Zone 

Add Insulotion (o Attic 

Floor 

Uninsulated Attic 

Existing 3-4 Inches of Insulation 

t 

R30 to R49 

R25 to R30 

R13 

2 

R30 to R60 

R25 to R38 

R13to R19 

3 

R30 to R60 

R25 to R38 

R19to R25 

4 

R38 to R60 

R38 

R25 to R30 

5 to 8 

R49 to R60 

R38 to R49 

R25 to R30 


Wall Insulation: Whenever exterior siding is removed on an 
Uninsulated wood-frame wall: 

• Ordi holes In me sheathing and blow insulation into me empty wall cavity before installing me new siding, and 

• Zones 3-4 Add R5 tnsuiative wall sheathing beneath me new siding 

• Zones 5-8 Add R5 to R6 insulative wall sheathing beneath the new siding 

Insulated wood-frame wall: 

• For Zones 4 to 8 Add R5 insulative sheathing before installing the new siding. 


FIGURE 7.3 Information 
Organized Spatially 

Source: EnergyStar, 2014: http://www 
.en e rgysta r.gov/?c= h o me_sea ling 
.hm_improvementJnsulation_table. 


This information is addressed to 
homeowners who want to add 
insulation to their attics or floors. 

To help readers understand how 
much insulation they need based 
on their climate, the writers could 
have used an alphabetical list of 
cities or states or zip codes. Instead, 
the writers chose a map because it 
enables readers to quickly and eas- 
ily"see"the climate in their region. 
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GENERALTO SPECIFIC 

The general-to-specific pattern is useful when your readers need a gen- 
eral understanding of a subject to help them understand and remember 
the details. For example, in a report, you include an executive summary — an 
overview for managers — before the body of the report. In a set of instructions, 
you provide general information about the necessary tools and materials and 
about safety measures before presenting the step-by-step instructions. In a 
blog, you describe the topic of the blog before presenting the individual blog 
posts. 

Figure 7.4, from the U.S. Department of State, explains the principles 
underlying the nation’s cybersecurity policy. 


These two suggestions can help you use the general-to-specific pattern effectively. 

► Provide signposts. Explain that you will address general issues first and then 
move on to specific concerns. If appropriate, incorporate the words general and 
specific or other relevant terms in the major headings or at the start of the text for 
each item you describe. 

► Consider using graphics to complement the text. Diagrams, drawings, photo- 
graphs, and maps help your reader understand both the general information and 
the fine points. 


MORE IMPORTANT TO LESS IMPORTANT 

The more-important-to-less-important organizational pattern recognizes 
that readers often want the bottom line — the most-important information — 
first. For example, in an accident report, you describe the three most important 
factors that led to the accident before describing the less-important factors. 
In a feasibility study about building a facility, you present the major reasons 
that the proposed site is appropriate, then the minor reasons. In a proposal 
to design a new microchip, you describe the major applications for the new 
chip, then the minor applications. 

For most documents, this pattern works well because readers want to get 
to the bottom line as soon as possible. For some documents, however, other 
patterns work better. People who write for readers outside their own com- 
pany often reverse the more-important-to-less-important pattern because 
they want to make sure their audience reads the whole discussion. This 
reversed pattern is also popular with writers who are delivering bad news. 

For instance, if you want to justify recommending that your organization 
not go ahead with a popular plan, the reverse sequence lets you explain the 
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problems with the popular plan before you present the plan you recommend. 
Otherwise, readers might start to formulate objections before you have had a 
chance to explain your position. 


The United States will confront these [cyberterrorism] challenges — while preserving 
our core principles. Our policies flow from a commitment to both preserving the best 
of cyberspace and safeguarding our principles. Our international cyberspace policy 
reflects our core commitments to fundamental freedoms, privacy, and the free flow of 
information. 

Fundamental Freedoms. Our commitment to freedom of expression and 
association is abiding, but does not come at the expense of public safety or the 
protection of our citizens. Among these civil liberties, recognized internationally as 
"fundamental freedoms," the ability to seek, receive and impart information and ideas 
through any medium and regardless of frontiers has never been more relevant. As 
a nation, we are not blind to those Internet users with malevolent intentions, but 
recognize that exceptions to free speech in cyberspace must also be narrowly tailored. 
For example, child pornography, inciting imminent violence, or organizing an act of 
terrorism have no place in any society, and thus, they have no place on the Internet. 
Nonetheless, the United States will continue to combat them in a manner consistent 
with our core values — treating these issues specifically, and not as referenda on the 
Internet's value to society. 

Privacy. Our strategy marries our obligation to protect our citizens and interests 
with our commitment to privacy. As citizens increasingly engage via the Internet in 
their public and private lives, they have expectations for privacy: individuals should be 
able to understand how their personal data may be used, and be confident that it will 
be handled fairly. Likewise, they expect to be protected from fraud, theft, and threats 
to personal safety that lurk online — and expect law enforcement to use all the tools 
at their disposal, pursuant to law, to track and prosecute those who would use the 
Internet to exploit others. The United States is committed to ensuring balance on both 
sides of this equation, by giving law enforcement appropriate investigative authorities 
it requires, while protecting individual rights through appropriate judicial review and 
oversight to ensure consistency with the rule of law. 

Free Flow of Information. States do not, and should not have to choose between 
the free flow of information and the security of their networks. The best cybersecurity 
solutions are dynamic and adaptable, with minimal impact on network performance. 
These tools secure systems without crippling innovation, suppressing freedom of 
expression or association, or impeding global interoperability. In contrast, we see other 
approaches — such as national-level filters and firewalls — as providing only an illusion 
of security while hampering the effectiveness and growth of the Internet as an open, 
interoperable, secure, and reliable medium of exchange. The same is true commercially; 
cyberspace must remain a level playing field that rewards innovation, entrepreneurship, 
and industriousness, not a venue where states arbitrarily disrupt the free flow of 
information to create unfair advantage. The United States is committed to international 
initiatives and standards that enhance cybersecurity while safeguarding free trade and 
the broader free flow of information, recognizing our global responsibilities, as well as 
our national needs. 


FIGURE 7.4 Information Organized from General to Specific 

Source: U.S. Department of State, 2011: www.whitehouse.gov/sites/default/files/rss_viewer/internationaLstrategy_for 
_cyberspace.pdf. 


The first paragraph is an advance 
organizer: a general summary of 
the topics that will be addressed in 
more detail. 

The three topics are announced in 
the italicized phrases. 

These phrases are used at the start 
of the three sections. 
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Organizing Information from More 
Important to Less Important 


These three suggestions can help you write a passage organized from more impor- 
tant to less important. 

► Provide signposts. Tell your readers how you are organizing the passage. For 
instance, in the introduction of a proposal to design a new microchip, you might 
write, "The three applications for the new chip, each of which is discussed below, 
are arranged from most important to least important." 

In creating signposts, be straightforward. If you have two very-important 
points and three less-important points, present them that way: group the two 
important points and label them something like "Major Reasons to Retain Our 
Current Management Structure."Then present the less-important factors as 
"Other Reasons to Retain Our Current Management Structure." Being straightfor- 
ward makes the material easier to follow and enhances your credibility. 

► Explain why one point is more important than another. Don't just say that you 
will be arranging the items from more important to less important. Explain why 
the more-important point is more important. 

► Consider using graphics to complement the text. Diagrams and numbered lists 
often help to suggest levels of importance. 


Figure 7.5, from the U.S. Department of Agriculture, shows the more- 
important-to-less-important organizational structure. 

COMPARISON AND CONTRAST 

Typically, the comparison-and-contrast pattern is used to describe and evalu- 
ate two or more items or options. For example, in a memo, you compare and 
contrast the credentials of three finalists for a job. In a proposal to design a 
new microchip, you compare and contrast two different strategies for design- 
ing the chip. In a uideo explaining different types of low-emissions vehicles, 
you compare and contrast electric cars and hybrids. 

The first step in comparing and contrasting two or more items is to deter- 
mine the criteria: the standards or needs you will use in studying the items. 
For example, if a professional musician who plays the piano in restaurants 
was looking to buy a new portable keyboard, she might compare and contrast 
available instruments using the number of keys as one criterion. For this 
person, 88 keys would be better than 64. Another criterion might be weight: 
lighter is better than heavier. 

Almost always, you will need to consider several or even many criteria. 
Start by deciding whether each criterion represents a necessary quality or 
merely a desirable one. In studying keyboards, for instance, the number of 
keys might be a necessary quality. If you need an 88-key instrument to play 
your music, you won’t consider any instruments without 88 keys. The same 
thing might be true of touch-sensitive keys. But a MIDI interface might be 
less important, a merely desirable quality; you would like MIDI capability, but 
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Writers of technical communication often have to explain why some information is more important than other 
information. To do so, they typically present the more-important information first and use words and phrases to 
signal the importance of the points they present. This paragraph sketches the background of the Forest Service's 
strategy for combatting the damage done by bark beetles. Notice that the problem the paragraph focuses on 
first is the health and safety risks posed by the falling trees. The next point, about the environmental impacts, is 
less important, as suggested by the word "also" in the final sentence. 


Here the writer uses the words 
"first"and"second"to signal priority. 
Safety is the most important issue; 
reforestation is less important, as 
suggested by the phrase "After the 
priority of safety."Thinning the for- 
ests is a lower priority, as suggested 
by the word "also" in the phrase 
"Forests will also be thinned." 


WESTERN BARK BEETLE STRATEGY OVERVIEW 

Across six states of the interior west, over 1 7.5 million acres of forested lands are 
infested by bark beetles. The infestation is growing at an estimated 600,000 acres a year 
with the potential to affect the majority of our western pine, fir and spruce forests. It is 
estimated that 1 00,000 beetle-killed trees are currently falling daily, posing a serious 
health and safety threat to forest visitors, residents and employees. The epidemic is also 
causing unprecedented environmental impacts. 

The Western Bark Beetle Stratec (PDF, 7.0 MB) developed in 201 1 identifies how the 
Forest Service is responding to and will respond to the western bark beetle epidemic 
over the next five years (FY 201 1-201 6). The extent of the epidemic requires prioritization 
of treatments, first providing for human safety in areas threatened by standing dead 
hazard trees, and second, addressing dead and down trees that create hazardous fuels 
conditions adjacent to high value areas. After the priority of safety, forested areas with 
severe mortality will be reforested with the appropriate species (recovery). Forests will 
also be thinned to reduce the number of trees per acre and create more diverse stand 
structures to minimize extensive epidemic bark beetle areas (resiliency). This is a modest 
strategy that reflects current budget realities, but focuses resources in the most important 
places that can make a big difference to the safety of the American public. 


FIGURE 7.5 Information Organized from More Important to Less Important 

Source: U.S. Department of Agriculture, 2012: http://www.fs.fed.us/restoration/Bark_Beetle/overview.shtml. 


you would not eliminate an instrument from consideration just because it 
doesn’t have MIDI. 

Two typical patterns for organizing a comparison-and-contrast discussion 
are whole -by -whole and part-by-part. The following example illustrates the 
difference between them. The example shows how two printers — Model 5L 
and Model 6L — might be compared and contrasted according to three criteria: 
price, resolution, and print speed. 


The whole-by-whole pattern 
provides a coherent picture of each 

Whole-by-whole 

Part-by-part 

Model 5L 

Price 

option: Model 5L and Model 6L. This 

pattern works best if your readers 

• price 

• Model 5L 

need an overall assessment of each 

• resolution 

• Model 6L 

option or if each option is roughly 

• print speed 

Resolution 

equivalent according to the criteria. 

Model 6L 

• Model 5L 


• price 

• Model 6L 


• resolution 

• print speed 

Print Speed 
• Model 5L 



• Model 6L 


The part-by-part pattern lets you 
focus your attention on the criteria. 
If, for instance, Model 5L produces 
much better resolution than Model 
6L, the part-by-part pattern reveals 
this difference more effectively than 
the whole-by-whole pattern does. 
The part-by-part pattern is best for 
detailed comparisons and contrasts. 
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GUIDELINES 


Organizing Information by 
Comparison and Contrast 


These four suggestions can help you compare and contrast items effectively. 


► Establish criteria for the comparison and contrast. Choose criteria that are con- 
sistent with the needs of your audience. 

► Evaluate each item according to the criteria you have established. Draw your 
conclusions. 

► Organize the discussion. Choose either the whole-by-whole or the part-by-part 
pattern or some combination of the two. Then order the second-level items. 

► Consider using graphics to complement the text. Graphics can clarify and em- 
phasize comparison-and-contrast passages. Diagrams, drawings, and tables are 
common ways to provide such clarification and emphasis. 


You can have it both ways. You can begin with a general description of the 
various items and then use a part-by-part pattern to emphasize particular 
aspects. 

Once you have chosen the overall pattern — whole-by-whole or part-by- 
part — you decide how to order the second-level items. That is, in a whole- 
by-whole passage, you have to sequence the aspects of the items or options 
being compared; in a part-by-part passage, you have to sequence the items or 
options themselves. 

Figure 7.6 shows a comparison-and-contrast table about employment in 
the labor force. 


ETHICS NOTE 


COMPARING AND CONTRASTING FAIRLY 

Because the comparison-and-contrast organizational pattern is used frequently in evaluating 
items, it appears often in product descriptions as part of the argument that one company's 
products are better than a competitor's. There is nothing unethical in this. But it is unethical 
to misrepresent items, such as when writers portray their own product as better than it is or 
portray their competitor's as worse than it is. 

Obviously, lying about a product is unethical. But some practices are not so easy to character- 
ize. For example, suppose your company makes tablet computers and your chief competitor's 
model has a longer battery life than yours. In comparing and contrasting the two tablets, are you 
ethically obligated to mention battery life? No, you are not. If readers are interested in battery 
life, it is their responsibility to figure out what your failure to mention battery life means and seek 
further information from other sources. If you do mention battery life, however, you must do so 
honestly, using industry-standard techniques for measuring it. You cannot measure your tablet's 
battery life under one set of conditions and your competitor's under another set. 

CLASSIFICATION OR PARTITION 

Classification is the process of assigning items to categories. For instance, all 
the students at a university could be classified by sex, age, major, and many 
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America’s Changing Labor Force 


The Equal Employment Opportunity (EEO) Tabulation, based on 
the American Community Survey (ACS), provides statistics on the 
demographics of the workforce by occupation. The U.S. Census 
Bureau has produced this tabulation after every census since the 
1970s. However, for the first time, this tabulation used five years of 
statistics from the American Community Survey (2006-2010). They 
serve as the primary benchmark for assessing the diversity of the labor 
force and monitoring compliance with civil rights laws. This infographic 
focuses on men and women in the civilian labor force and what we can 
learn from the EEO tabulations over the past five decades. 


Men 


Leading Occupations 
2006-2010 


Women 


8 


Truck drivers 3.2M 

Miscellaneous managers ... 2.1M 
Freight, stock, and material 


Secretaries and administrative 


. 1.9M 
1970 

Miscellaneous managers 1.9M i 

Truck drivers l.SM 

Production supervisors . 1.4M QJU Elementary school teachers 1.3M 

Occupational Growth Since 2000 


assistants 

3.8M 

Elementary and middle school 


2.8M 

Bookkeepers 

1.4M 




Men's representation grew 
among tellers, loan interviewers 
and clerks, and insurance claims 
and policy processing clerks. 




Some of the occupations with the 
largest increases in women's 
representation were dentists, 
veterinarians, and physicians and 
surgeons. 


% 


Leading Industries 


Manufacturing employed the 
largest number of men: 10.8M. 


T 


Educational services, health care, 
and social assistance employed the 
largest number of women: 22.4M. 


FIGURE 7.6 Informa- 
tion Organized by Com- 
parison and Contrast 

Source: U.S. Census Bureau, 2014: http:// 

www.census.gov/how/infographics 

/acs_infographic_eeo.html. 


This excerpt from an infographic 
published by the federal govern- 
ment presents a lot of information 
about employment in the civilian 
labor force in the United States, 
nowand in 1970. The main theme 
is the comparison between men 
and women: how many are in the 
workforce and what jobs they hold 
or held. Because the main basis of 
comparison and contrast is the sex 
of workers, the writers chose a basic 
table structure, with data about 
men in one column and data about 
women in the other. 


other characteristics. You can also create subcategories within categories, 
such as males and females majoring in business. 

Classification is common in technical communication. In a feasibility For more about feasibility reports, 

study about building a facility, you classify sites into two categories: domes- seeCh. 18, p.469. 
tic or foreign. In a journal article about ways to treat a medical condition, 
you classify the treatments as surgical or nonsurgical. In a description of a 
major in a college catalog, you classify courses as required or elective. 

Partition is the process of breaking a unit into its components. For example, 
a home-theater system could be partitioned into the following components: 

TV, amplifier, peripheral devices such as DVD players, and speakers. Each 
component is separate, but together they form a whole system. Each compo- 
nent can, of course, be partitioned further. 

Partition is used in descriptions of objects, mechanisms, and processes. 

In an equipment catalog, you use partition to describe the major components 
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of one of your products. In a proposal, you use partition to present a 
detailed description of an instrument you propose to develop. In a 
brochure, you explain how to operate a product by describing each of its 
features. 

In Figure 7.7, the writer uses classification effectively in introducing cat- 
egories of tornados to a general audience. 

Figure 7.8 illustrates partition. For more examples of partition, see Chapter 
20, which includes descriptions of objects, mechanisms, and processes. 


These six suggestions can help you write an effective classification or partition passage. 

► Choose a basis of classification or partition that fits your audience and pur- 
pose. If you are writing a warning about snakes for hikers in a particular state 
park, your basis of classification will probably be whether the snakes are poison- 
ous. You will describe all the poisonous snakes, then all the nonpoisonous ones. 

► Use only one basis of classification or partition at a time. If you are classifying 
graphics programs according to their technology — paint programs and draw 
programs — do not include another basis of classification, such as cost. 

► Avoid overlap. In classifying, make sure that no single item could logically be 
placed in more than one category. In partitioning, make sure that no listed com- 
ponent includes another listed component. Overlapping generally occurs when 
you change the basis of classification or the level at which you are partitioning a 
unit. In the following classification of bicycles, for instance, the writer introduces a 
new basis of classification that results in overlapping categories: 

— mountain bikes 
— racing bikes 
— comfort bikes 
— ten-speed bikes 

The first three items share a basis of classification: the general category of bicycle. 
The fourth item has a different basis of classification: number of speeds. Adding 
the fourth item is illogical because a particular ten-speed bike could be a moun- 
tain bike, a racing bike, or a comfort bike. 

► Be inclusive. Include all the categories necessary to complete your basis of clas- 
sification. For example, a partition of an automobile by major systems would be 
incomplete if it included the electrical, fuel, and drive systems but not the cooling 
system. If you decide to omit a category, explain why. 

► Arrange the categories in a logical sequence. Use a reasonable plan, such as 
chronology (first to last), spatial development (top to bottom), or importance 
(most important to least important). 

► Consider using graphics to complement the text. Organization charts are com- 
monly used in classification passages; drawings and diagrams are often used in 
partition passages. 
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Explanation of EF-Scale Ratings 


Over the course of April 27th, 2011, damage across the entire range of the EF scale was sustained in some portion of the 
Huntsville County Warning Forecast Area. Belov/ is a chart that explains what type of damage is associated with each 
ranking on the EF scale, including example photographs from the April 27th event 


EF Rating 

Wind Speeds 

Expected Damage 

EF-0 

65-85 mph 

'Minor' damage: shingles blown off or parts of a 
roof peeled off, damage to gutters/siding, 
branches broken off trees, shallow rooted trees 
toppled. 


EF-1 

86-110 mph 

'Moderate' damage: more significant roof 
damage, windows broken, exterior doors 
damaged or lost, mobile homes overturned or 
badly damaged. 


EF-2 

111-135 mph 

'Considerable' damage: roofs torn off well 
constructed homes, homes shifted off their 
foundation, mobile homes completely 
destroyed, large trees snapped or uprooted, 
cars can be tossed. 


EF-3 

136-165 mph 

'Severe' damage: entire stories of well 
constructed homes destroyed, significant 
damage done to large buildings, homes with 
weak foundations can be blown away, trees | 
begin to lose their bark. 

^ a, spates 

EF-4 


'Extreme' damage: Well constructed homes are 
leveled, cars are thrown significant distances, 
top story exterior walls of masonry buildings 
would likely collapse. 

; IlisJ 

EF-5 

> 200 mph 

'Massive/incredible' damage: Well constructed j 
homes are swept away, steel-reinforced 
concrete structures are critically damaged, | 
high-rise buildings sustain severe structural 1 
damage, trees are usually completely debarked, 
stripped of branches and snapped. 




FIGURE 7.7 Information Organized by Classification 

The Enhanced Fujita (EF) rating scale classifies tornados according to their wind speed and destructiveness. 
Source: National Oceanic and Atmospheric Administration, 201 2 Explanation of EF-scale ratings: www.srh.noaa.gov 
/hun/?n=efscale_explanation. 


PROBLEM-METHODS-SOLUTION 

The problem-methods-solution pattern reflects the logic used in carrying out 
a project. The three components of this pattern are simple to identify: 

• Problem. A description of what was not working (or not working 
effectively) or what opportunity exists for improving current processes. 

• Methods. The procedures performed to confirm the analysis of the 
problem, solve the problem, or exploit the opportunity. 

• Solution. The statement of whether the analysis of the problem was 
correct or of what was discovered or devised to solve the problem or 
capitalize on the opportunity. 

The problem-methods-solution pattern is common in technical communi- 
cation. In a proposal, you describe a problem in your business, how you plan 
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FIGURE 7.8 Information 
Organized by Partition 

Source: U.S. Department of Energy, 201 3: 
http://www2.eere.energy.gov/wind 
/printable_versions/inside_a_wind 
_turbine.html. 


This example of partition begins 
with a textual overview of the topic. 


This interactive graphic enables the 
reader to see the components of 
the wind turbine in operation as the 
equipment generates electricity. 


Following this graphic is a descrip- 
tion of each of the components 
shown in the graphic. 


THE INSIDE OF A WINDTURBINE 

Wind turbines harness the power of the wind and use it to generate electricity. Simply 
stated, a wind turbine works the opposite of a fan. Instead of using electricity to make 
wind, like a fan, wind turbines use wind to make electricity. The energy in the wind turns 
two or three propeller-like blades around a rotor. The rotor is connected to the main 
shaft, which spins a generator to create electricity. This illustration provides a detailed 
view of the inside of a wind turbine, its components, and their functionality. 



Blades 


Low-speed shaft 
- . Gearbox 


Controller 


Anemometer 


Yaw drive 


Wind vane 


Nacelle 


Yaw motor 




S8B i 


Pitch system 


Wind direction 


HI 


Tower - v . High-speed shaft 

Generator 


u.s. otrAJtTMcw t or 

ENERGY 


Energy Efficiency & 
Renewable Energy 


to carry out your research, and how your deliverable (an item or a report) can 
help solve the problem. In a completion report about a project to improve a 
manufacturing process, you describe the problem that motivated the project, 
the methods you used to carry out the project, and the findings: the results, 
conclusions, and recommendations. 
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Organizing Information by 
Problem-Methods-Solution 


These five suggestions can help you write an effective problem-methods-solution 
passage. 

► In describing the problem, be clear and specific. Don't write, "Our energy expen- 
ditures are getting out of hand." Instead, write, "Our energy usage has increased 
7 percent in the last year, while utility rates have risen 1 1 percent."Then calculate 
the total increase in energy costs. 


( continued ) 
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► In describing your methods, help your readers understand what you did 

and why you did it that way. You might need to justify your choices. Why, for 
example, did you use a t-test in calculating the statistics in an experiment? If you 
can't defend your choice, you lose credibility. 

► In describing the solution, don't overstate. Avoid overly optimistic claims, such 
as "This project will increase our market share from 7 percent to 10 percent within 
12 months." Instead, be cautious:"This project could increase our market share 
from 7 percent to 1 0 percent."This way, you won't be embarrassed if things don't 
turn out as well as you had hoped. 

► Choose a logical sequence. The most common sequence is to start with the prob- 
lem and conclude with the solution. However, different sequences work equally well 
as long as you provide a preliminary summary to give readers an overview and in- 
clude headings or some other design elements to help readers find the information 
they want (see Chapter 11). For instance, you might want to put the methods last if 
you think your readers already know them or are more interested in the solution. 

► Consider using graphics to complement the text. Graphics, such as flowcharts, 
diagrams, and drawings, can clarify problem-methods-solution passages. 


Figure 7.9 shows the problem-methods-solution pattern. The passage is from a 
case study of a police department using TASER equipment to solve two problems. 

CAUSE AND EFFECT 

Technical communication often involves cause-and-effect discussions. 
Sometimes you will reason forward, from cause to effect: if we raise the 
price of a particular product we manufacture (cause), what will happen to 
our sales (effect)? Sometimes you will reason backward, from effect to cause: 
productivity went down by 6 percent in the last quarter (effect); what factors 
led to this decrease (causes)? Cause-and-effect reasoning, therefore, provides 
a way to answer the following two questions: 

• What will be the effect(s) of X? 

• What caused X? 

Arguments organized by cause and effect appear in various types of technical 
communication. In an environmental impact statement, you argue that a proposed 
construction project would have three important effects on the ecosystem. In 
the recommendation section of a report, you argue that a recommended solution 
would improve operations in two major ways. In a memo, you describe a new 
policy and then explain the effects you anticipate the policy will have. 

Cause-and-effect relationships are difficult to describe because there is no 
scientific way to determine causes or effects. You draw on your common sense 
and your knowledge of your subject. When you try to determine, for example, 
why the product your company introduced last year sold poorly, you start with 
the obvious possibilities: the market was saturated, the product was of low 
quality, the product was poorly marketed, and so forth. The more you know 
about your subject, the more precise and insightful your analysis will be. 

But a causal discussion can never be certain. You cannot prove why a 
product failed in the marketplace; you can only explain why the factors you 
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"Challenge" presents the problem 
at the Rialto, California, police 
department. 


"Solution" begins with a discussion of 
the methods the police department 
took to solve the two problems. 


Note that writers do not necessarily 
use the words problem, methods, 
and solution in this method of 
organization. Don't worry about the 
terminology; the important point is 
to recognize that this organizational 
pattern is based on identifying 
a problem, doing something to 
respond to it, and thereby reducing 
or solving it. 


Challenge When facing the public, Rialto PD found two main areas for improvement: 
Use of Force, and Officer Complaints. These issues cost the department valuable time 
and resources. Rialto PD believed that improving oversight, gathering more video 
evidence, and improving trust within the community would decrease the frequency of 
these issues. 

Solution Rialto PD invested in TASER's Digital Evidence Ecosystem, AXON flex and 
EVIDENCE.com. After purchasing 66 cameras and licenses to EVIDENCE.com, the PD 
began a scientific research study to determine the effects of TASER's AXON flex and 
EVIDENCE.com solution. 

To protect the integrity of data gathered during the experiment, Rialto PD used 
the"Cambridge Randomizer"and followed a strict scientific process. This strategy 
shaped a sophisticated, Web-based experiment with data protected from outside 

influences Because of Rialto PD's extensive data gathering and controlled study, 

the data is compelling. Over the course of 1 year, officer complaints fell by 87.5% in the 
experimental group. The data shows the officers increased interactions with the public 
compared to the previous year, and still complaints fell dramatically. 


Monthly Complaints Received 


9- 1 




Decrease in Complaints 



Rialto PD also focused on their Officer use-of-force data. During the experiment, 
individuals wearing an AXON flex reduced use-of-force by 59%. This data indicates that 
the presence of the camera not only encouraged compliance from the public but it also 
reduced instances of use offeree by officers. 


Patrol Officer's Use-of-Force 


Start of Experiment 


Reduced Use-of-Force 



FIGURE 7.9 Information Organized by the Problem-Methods-Solution 
Pattern 

Reprinted by permission ofTASER International, Inc. 
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are identifying are the most plausible causes or effects. For instance, to make 
a plausible case that the main reason for the product’s weak performance is 
that it was poorly marketed, you can show that, in the past, your company’s 
other unsuccessful products were marketed in similar ways and your com- 
pany’s successful products were marketed in other ways. 

Figure 7.10 illustrates an effective cause-and-effect argument. The writer 
is explaining why electric vehicles have not sold well in the United States. 


A 


GUIDELINES 


Organizing Information by Cause and Effect 


These four suggestions can help you write an effective cause-and-effect passage. 


► Explain your reasoning. To support your claim that the product was marketed 
poorly, use specific facts and figures: the low marketing budget, delays in begin- 
ning the marketing campaign, and so forth. 

► Avoid overstating your argument. For instance, if you write that Bill Gates, the 
co-founder of Microsoft, "created the computer revolution, "you are claiming too 
much. It is better to write that Gates "was one of the central players in creating 
the computer revolution." 

► Avoid logical fallacies. Logical fallacies, such as hasty generalizations or post hoc 
reasoning, can also undermine your discussion. 

► Consider using graphics to complement the text. Graphics, such as flowcharts, 
organization charts, diagrams, and drawings, can clarify and emphasize cause- 
and-effect passages. 


For more about logical fallacies, see 
Ch. 8, p. 182. 


Electric motors are superior to internal-combustion engines — on paper, at least. They 

have better torque, they have only one moving part, and they are easy to maintain. 

But the sales of all-electric cars in the United States have been weak. Four factors are 

holding back the sales of all-electric cars: 

• Range. The electric car with the best range is theTesla, which claims 300 miles, but 
the Tesla is a $1 00,000 two-seater. The Nissan Leaf, the best-selling electric car, claims 
only 100 miles. Compared to a gasoline-powered car, with a range of 300-500 miles, 
the electric car simply isn't practical for someone who doesn't already have a standard 
car to use for long trips. 

• Charge time. On a 1 20-volt outlet, the Leaf takes almost 20 hours. On a 240-volt, it's 
7 hours. Few drivers want to plan their trips around downtimes as long as that. 

• Infrastructure. In the New York City area, one of the most densely populated regions 
in the country, there are only 1 1 charging stations within a 10-mile radius of midtown 
Manhattan. In that same region, there are 35 gas stations. In 2012, there were 1 25,000 
gas stations in the nation, but only 1 0,000 electric-car charge points. 

• Cost. The enormous R&D costs of electric cars are being passed on to consumers. 

Take the case of the Chevrolet Volt and the Chevy Cruze, roughly comparable cars. 
The Volt — after tax credits — costs about $32,500; the gas-powered Cruze, less than 
$20,000. At $4 per gallon for gas, you would need to drive the Volt about 88,000 miles 
(about 6 years for the average driver) to make up the difference in fuel savings. 


The first paragraph presents the 
effect in this cause-effect argument: 
electric cars are not popular in the 
United States. 

The bullet list presents four causes. 


FIGURE 7.10 A Discussion Organized by the Cause-and-Effect Pattern 
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ORGANIZING YOUR INFORMATION 


DOCUMENT ANALYSIS ACTIVITY 


Using Multiple Organizational Patterns in an Infographic 


This infographic about how job seekers in England use social media presents three sets of data, each of which uses a different organiza- 
tional pattern. The questions below ask you to think about the organizational patterns. 


1 . On the left, Facebook and Linkedln are 
compared in two pairs of graphics. Is 
the comparison in each pair clear and 
easy to understand? Would other types 
of graphics be easier to understand? 


2 . In the middle section of the info- 
graphic, which organizational pattern 
is being used? Flow effective is it in 
helping readers understand the 
information? 


3 . What are the two organizational pat- 
terns being used to communicate the 
data in the map of England? 


SOCIAL MEDIA & STAFF RECRUITMENT 


Facebook vs Linkedln 



43% 

of Britons prefer to 
lovorago Facebook 
fnonds to find their 
dream job 



22% 

ol Britons prefer to 
leverage Linkedln 
notworks to find 
their dream job 


vfvviviivi mimm 

VVVVVVVVVV 

iiiivtivvr Tvvvmviv 
vvvmvvvf 

miifTT 


55% 

ol womon turn to 
Facebook for job 
hunting advice 


58% 

of men profor 
Linkodln 


unum 


Top social network job 
hunters by sector 

% of respondents that 
use social networks to 
find work 


RETAIL 



PR, ADVERTISING 
& MARKETING 


Source Adzurvt 


co uk Press Association Graphic 



Scotland 

7.2% 


Yorks & Humb I 

10 . 2 % 


Biggest Networkers by UK region 

% of respondents who've been hired with a little help 
from thoir frionds 



1-4% 5-9% 10-14% 15-19% 


Source: Unum, 2013: http://blog.unum.co.uk/news-and-views/3-staff-recruitment-problems-that-social-media-solves. Used by permission of Unum Ltd. 
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WRITER'S CHECKLIST 


I I Did you analyze your audience and purpose? 

(p. 147) 

LJ Did you consider using a conventional pattern of 
organization? fp. 148) 

Did you display your organizational pattern prominently by 

□ creating a detailed table of contents? (p. 149) 

□ using headings liberally? (p. 149) 

□ using topic sentences at the beginnings of your 
paragraphs? (p. 149) 

The following checklists cover the eight organizational 

patterns discussed in this chapter. 

Chronological and Spatial 

Did you 

LJ provide signposts, such as headings and transitional 
words or phrases? (pp. 151, 153) 

LJ consider using graphics to complement the text? 

(pp. 152, 153) 

LJ analyze events where appropriate? (pp. 152, 153) 

General to Specific 

Did you 

I provide signposts, such as headings and transitional 

words or phrases? (p. 154) 

LJ consider using graphics to complement the text? 

(p. 154) 

More Important to Less Important 

Did you 

LJ provide signposts, explaining clearly that you are using 
this organizational pattern? (p. 156) 

_J explain why the first point is the most important, the 
second is the second most important, and so forth? 

(p. 156) 

LJ consider using graphics to complement the text? 

(p. 156) 


Comparison and Contrast 

Did you 

LJ establish criteria for the comparison and contrast? 

(p. 158) 

□ evaluate each item according to the criteria you 
established? (p. 158) 

□ organize the discussion by choosing the pattern — 
whole-by-whole or part-by-part — that is most 
appropriate for your audience and purpose? (p. 158) 

LJ consider using graphics to complement the text? (p. 158) 

Classification or Partition 

Did you 

LJ choose a basis of classification or partition that fits your 
audience and purpose? (p. 160) 

□ use only one basis of classification or partition at a time? 

(p. 160) 

LJ avoid overlap? (p. 160) 

LJ include all the appropriate categories? (p. 160) 

□ arrange the categories in a logical sequence? (p. 160) 

LJ consider using graphics to complement the text? (p. 160) 

Problem-Methods-Solution 

Did you 

LL describe the problem clearly and specifically? (p. 162) 

LJ if appropriate, justify your methods? (p. 163) 

LJ avoid overstating your solution? fp. 163) 

□ arrange the discussion in a logical sequence? (p. 163) 

LJ consider using graphics to complement the text? fp. 163) 

Cause and Effect 

Did you 

LJ explain your reasoning? fp. 765? 

LJ avoid overstating your argument? fp. 165) 

[LJ avoid logical fallacies? fp. 165) 

LJ consider using graphics to complement the text? fp. 165) 
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EXERCISES 


1. Find the website of a company that makes a product 
used by professionals in your field. (Personal computers 
are a safe choice.) Locate three discussions on the site 
that use different organizational patterns. For example, 
there will probably be a passage devoted to ordering a 
product from the site (using a chronological pattern), a 
description of a product (using a partition pattern), and 
a passage describing why the company's products are 
superior to those of its competitors (using a comparison- 
and-contrast argument). Print a copy of the passages 
you've identified. 

2 . For each of the lettered topics that follow, identify 
the best organizational pattern for a discussion of the 
subject. For example, a discussion of distance education 
and on-campus courses could be organized using 

the comparison-and-contrast pattern. Write a brief 
explanation of why the organizational pattern you 
chose for each topic would be the best one to use. (Use 
each of the organizational patterns discussed in this 
chapter at least once.) 

a. how to register for courses at your college or 
university 

b. how you propose to reduce the time required to 
register for classes or to change a schedule 

c. your car's dashboard 

d. the current price of gasoline 

e. advances in manufacturing technology 

f. the reasons you chose your college or major 

g. a student organization on your campus 


h. two music-streaming services 

i. tablet computers 

j. how you propose to increase the ties between your 
college or university and local business and industry 

k. college courses 

l. increased security at airports 

m. the room in which you are sitting 

n. the three most important changes you would like to 
see at your school 

o. a guitar 

p. cooperative education and internships for college 
students 

q. howto prepare for a job interview 

3 . You are researching portable GPS systems for use in 
your company's existing fleet of 35 delivery vans. You 
are considering such factors as ease of use, size of 
screen, number of points of interest, and Bluetooth 
compatibility. You conclude that the three leading 
models are quite similar in all but one way: price. 

One model costs about 30 percent less than the other 
two models. In organizing your discussion of the three 
models, should you use the whole-by-whole pattern or 
the part-by-part pattern? Why? 

4 . Write a 500-word discussion of one of the lettered 
topics in Exercise 2. If appropriate, include graphics. 
Preface your discussion with a sentence explaining the 
audience and purpose of the discussion. 


For more practice with the concepts covered in Chapters 7 and 9, 
la complete the LearningCurve activity "Organizing and 
Emphasizing Your Information" under "Additional Resources" in Ch. 7: 

macmillanhighered.com/launchpad/techcomm1 1 e. 


CASE 7: Organizing a Document for Clarity — and Diplomacy 



As part of your participation in a teaching-quality initiative for your school's Department 
of Civil Engineering, you have been assigned to write a brief report that summarizes 
student evaluations of the department's introductory course. When your supervisor 
expresses concerns about the report outline you sent her for review, you decide to revisit 
the organizational patterns covered in this chapter to see how they can help you develop a 
more effective structure for the report. To read your supervisor's email and start revising the 
outline, go to "Cases" under "Additional Resources" in Ch. 7: macmillanhighered.com 
/launchpad/techcomml 1 e. 
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TECHNICAL COMMUNICATION, like any other kind of communication, calls for 
making persuasive claims and supporting them effectively. It is a mistake to think 
that technical communication is only about facts. Certainly, facts are important. 

But communication is about determining which facts are appropriate, describing 
the context that helps people understand what those facts mean, and presenting 
a well-reasoned argument about those facts. Your job as a communicator is to 
convince a reader of a viewpoint — about what factors caused a situation, for 
example, or what a company ought to do to solve a problem. If you are lucky, you 
will be reinforcing a viewpoint the reader already holds. Sometimes, however, you 
will want to change the reader's mind. Regardless, you are presenting an argument: 
an arrangement of facts and judgments about some aspect of the world. 

This chapter explains how to craft a persuasive argument, avoid logical 
fallacies, present yourself effectively, and use graphics in your arguments. 

Considering the Context of Your Argument 

An argument can be as short as a sentence or as long as a multivolume 
report. It can take many forms, including oral communication. And it can 
discuss almost any kind of issue. Here are some examples: 

• From a description of a construction site: 

Features A, B, and C characterize the site. 

• From a study of why a competitor is outselling your company: 

Company X's dominance can be attributed to four major factors: A, B, C, and D. 

• From a feasibility study considering four courses of action: 

Alternative A is better than alternatives B, C, and D. 

• From a set of instructions for performing a task: 

The safest way to perform the task is to complete task A, then task B, and so on. 

Before you can develop an effective argument, you must understand your 
audience’s broader goals and your own constraints. 

UNDERSTANDING YOUR AUDIENCE'S BROADER GOALS 

When you analyze your audience, consider the values that motivate them. 
Most people are concerned about their own welfare and interests within the 
company, but they also want their company and their colleagues to prosper. 
If your document is intended for the public, as opposed to the employees in 
an organization, consider your audience’s personal goals — their desire for 
health and well-being, for example, or their need to feel safe. Your argument 
is most likely to be effective if it responds to four goals that most people 
share: security, recognition, growth, and connectedness. 

Security People resist controversial actions that might hurt their own inter- 
ests. Those who might lose their jobs will likely oppose an argument that their 
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division be eliminated, even if there are many valid reasons to support the 
argument. Another aspect of security is workload; most people resist an argu- 
ment that calls for them to work more. People also want security outside the 
workplace — for instance, in their health care, finances, and personal safety. If 
you are drafting a press release about the addition of bicycle lanes to a town’s 
already-congested streets, you need to assure residents that the town’s civil engi- 
neers took the proper steps to ensure that the bike lanes were designed safely. 

Recognition People like to be praised for their hard work and their suc- 
cesses. Where appropriate, be generous in your praise. Similarly, people hate 
being humiliated. Therefore, allow people to save face. Avoid criticizing their 
actions or positions and speculating about their motivations. Instead, present 
your argument as a response to the company’s or other stakeholders’ pres- 
ent and future needs. Look ahead, not back, and be diplomatic. A persuasive 
advertisement for a hospital’s weight-loss support group will not criticize 
potential members for their lack of exercise or poor diet; rather, it will recog- 
nize that they have already been working hard to maintain their health. 

One type of workplace document that is used to recognize professional 
success is a newsletter. A newsletter, a short newspaper published by an 
organization, can help the organization foster a sense of community within 
its membership, both internal and external, including customers, employees, 
investors, and the general public. Newsletters often include descriptions of 
new activities undertaken by the organization; major investments by the 
organization in new equipment or facilities; announcements for upcoming 
events and summaries of previous events, such as presentations, perfor- 
mances, or lectures given by organization members; notices of jobs available 
in the organization; profiles of new members, officers, or administrators; 
and important changes in relevant laws or regulations. Figure 8.1 shows an 
excerpt from a U.S. Department of Labor newsletter. 

Growth People want to develop and grow. They want to learn new skills 
and assume new duties. People also want to work for an organization that 
is developing and growing. Your argument will be more persuasive if you 
can show how the recommended action will help an organization improve 
the quality of its products or services, branch out into new areas, or serve 
new customers and stakeholders. A brochure advertising a CPR certification 
course might emphasize the sense of empowerment that comes with the 
ability to assist loved ones in danger. 

Connectedness People like to be part of communities, whether at work or 
at home. In the workplace, connectedness can take many forms, from work- 
ing with others on project teams to participating in company sports leagues 
to helping improve the community. Organizations that encourage employees 
to connect with their peers through social media such as wikis, blogs, and 
discussion boards help satisfy this human need for community. A new trend 
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DOL in Action 

San Francisco Giants Pay $545,000 in Back Wages, Damages 

The San Francisco Giants baseball team has paid $544,71 5 in back wages and liquidated 
damages to 74 employees after an investigation determined that the major league 
club failed to properly pay the workers. As a result of the investigation, Major League 
Baseball and the department are now working to ensure that all teams are aware of 
and adhere to the requirements of the Fair Labor Standards Act. Investigators with the 
department's Wage and Hour Division found minimum wage, overtime pay and record- 
keeping violations. The violations affected a range of employees in the organization at 
the major and minor league levels, including clubhouse assistants and managers. 

• Read the News Release 

Ohio Company Liable for Nearly $1.5 Million in Back Wages 

The U.S. District Court for the Southern District of Ohio found Cascom Inc. liable for 
$1,474,266 in back wages and liquidated damages. According to the lawsuit filed by the 
department, approximately 250 cable installers had been misclassified as independent 
contractors by the Fairfield, Ohio, company. The court issued its findings following 
an investigation by the Wage and Hour Division. Previously, the court ruled that the 
company and its owner, Julia J. Gress, had misclassified the employees and violated the 
Fair Labor Standards Act by failing to compensate them for hours worked in excess of 
40 per workweek. 

• Read the News Release 


FIGURE 8.1 Recognizing Accomplishments in a Newsletter 

Newsletter articles that report on the activities and accomplishments of the organization not only help keep 
employees informed but also improve employee morale by making them feel that they are making a 
difference and that their efforts are appreciated. 

Source: U.S. Department of Labor, 201 3: www.dol.gov/_sec/newsletter/201 3/201 30829.pdf. 


in the working world is to encourage employees to spend weeks 
or even months of company time working on community educa- 
tional or environmental projects. These projects not only improve 
the organization’s image but also help employees feel connected 
to the community. 

Figure 8.2 shows an example of a program that takes advan- 
tage of people’s need for connectedness. Citizens Connect is a 
Boston-based initiative that enables city residents to download 
an app that lets them report infrastructure problems, such as 
graffiti or broken street lights. 

FIGURE 8.2 Promoting Connectedness 

Citizens use a free app on their mobile devices to photograph and report problems. Since 
the City of Boston started Citizens Connect in 20 1 1, satisfaction with city services has risen 
22 percent. 

Source: City of Boston, 2013: http://www.cityofboston.gov/doit/apps/citizensconnect.asp. Used by 
permission of the City of Boston. 




Recent Reports 


Other report at 446 W Broadway, Boston 

All of the litter barrels in Southie are overflowing. 


Other report at 27-34 Thomas Park, Boston 

Abandoned cart 


Sidewalk Patch report at 183 Orleans St, Boston 

Sidewalk asphalt patch tag 6 
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For more about ethical and legal 
constraints, see Ch. 2. 


For more about collaboration, see 
Ch. 4. 


WORKING WITHIN CONSTRAINTS 

In planning a persuasive document, you need to work within the constraints 
that shape your environment on the job. As a student, you routinely work 
within constraints: the amount of information you can gather for a paper, 
the required length and format, the due date, and so forth. On the job, you 
will face similar constraints, which fall into eight categories: ethical, legal, 
political, informational, personnel, financial, time, and format and tone. 

Ethical Constraints Your greatest responsibility is to your own sense of 
what constitutes ethical behavior. Being asked to lie or mislead challenges 
your ethical standards directly, but in most cases you have options. Some 
organizations and professional communities have a published code of con- 
duct. In addition, many large companies have ombudspersons: ethics officers 
who use mediation to help employees resolve ethical conflicts. 

Legal Constraints You must abide by all applicable laws on labor practices, 
environmental issues, fair trade, consumer rights, and so forth. If you think 
you have been asked to do something that might be illegal, meet with your 
organization’s legal counsel and, if necessary, with attorneys outside the 
organization. 

Political Constraints Don’t spend all your energy and credibility on a los- 
ing cause. If you know that your proposal would help the company but that 
management disagrees with you or that the company can’t afford to approve 
it, either consider what you might achieve through some other means or 
scale back the idea. Two big exceptions to this rule are matters of ethics and 
matters of safety. As discussed in Chapter 2, ethical and legal constraints 
might mean compromise is unacceptable. 

Informational Constraints The most common informational constraint 
you might face is that you cannot get the information you need. You might 
want your organization to buy a piece of equipment, for example, but be 
unable to find unbiased evidence that would convince a skeptical reader. 

What do you do? You tell the truth. Explain the situation, weighing the 
available evidence and carefully noting what is missing. If you unintention- 
ally suggest that your evidence is better than it really is, you will lose your 
most important credential: your credibility. 

Personnel Constraints The most typical personnel constraint you might 
face is a lack of access to as many collaborators as you need. In such cases, 
present a persuasive proposal to hire the personnel you need. However, don’t 
be surprised if you have to make do with fewer people than you want. 


Financial Constraints Financial constraints are related to personnel 
constraints: if you had unlimited funds, you could hire all the personnel you 
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need. But financial constraints can also affect other kinds of resources: you 
might not be able to print as many copies of a document as you want, or you 
might need to settle for black and white instead of full color. 

Time Constraints Start by determining the document’s deadline. (Some- 
times a document will have several intermediate deadlines.) Then create a 
schedule. Keep in mind that tasks almost always take longer than estimated. 
And when you collaborate, the number of potential problems increases, 
because when one person is delayed, others may lack the necessary informa- 
tion to proceed, causing a logjam. 

Format and Tone Constraints You will also be expected to work within 
constraints on format and tone. 

• Format. Format constraints are limitations on the size, shape, or style of a 
document. For example, your reader might like to see all tables and figures 
presented at the end of the report. If you are writing to someone in your 
own organization, follow the format constraints described in the company 
style guide, if there is one, or check similar documents to see what other 
writers have done. Also ask more-experienced co-workers for their advice. 
If you are writing to someone in another organization, learn what you can 
about that organization’s preferences. 

• Tone. When addressing superiors, use a formal, polite tone. When 
addressing peers or subordinates, use a less-formal tone but be equally 
polite. 


Crafting a Persuasive Argument 

Persuasion is important, whether you wish to affect a reader’s attitude or 
merely present information clearly. To make a persuasive case, you must 
identify the elements of your argument, use the right kinds of evidence, con- 
sider opposing viewpoints, appeal to emotions responsibly, decide where to 
state your claim, and understand the role of culture in persuasion. 

IDENTIFYING THE ELEMENTS OF YOUR ARGUMENT 

A persuasive argument has three main elements: 


The evidence: the 
facts and judgments 



The claim: the idea 

that support your , 

claim 

k " you are communicating 


The reasoning: the 
logic you use to derive 
the claim from the 



evidence 




For more about scheduling, see 
Ch. 3, p. 47. 
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For advice on evaluating information 
from the Internet, see Ch. 6, p. 131. 


The claim is the conclusion you want your readers to accept. For example, 
your claim might be that your company should institute flextime, a schedul- 
ing approach that gives employees some flexibility in when they begin and 
end their workdays. You want your readers to agree with this idea and to take 
the next steps toward instituting flextime. 

The evidence is the information you want your readers to consider. For the 
argument about flextime, the evidence might include the following: 

• The turnover rate of our employees with young children is 50 percent 
higher than that of our employees without young children. The turnover 
rate for female employees with young children is double that of all 
employees without young children. 

• At exit interviews, 40 percent of our employees with young children stated 
that they quit so that they could be home for their school-age children. 

• Replacing a staff-level employee costs us about one-half the employee’s 
annual salary; replacing a professional-level employee costs a whole year’s 
salary. 

• Other companies have found that flextime significantly decreases 
turnover among employees with young children. 

• Other companies have found that flextime has additional benefits and 
introduces no significant problems. 

The reasoning is the logic you use to connect the evidence to your claim. In 
the discussion of flextime, the reasoning involves three links: 

• At other companies, flextime appears to have reduced the turnover 
problem among employees with young children. 

• Our company is similar to these other companies. 

• Flextime is therefore likely to prove helpful at our company. 

USING THE RIGHT KINDS OF EVIDENCE 

People most often react favorably to four kinds of evidence: “commonsense” 
arguments, numerical data, examples, and expert testimony. 

• "Commonsense" arguments. Here, commonsense means “Most people 
would think that . . . .’’The following sentence presents a commonsense 
argument that flextime is a good idea: 

Flextime makes sense because it gives people more control over how they plan 
their schedules. 

A commonsense argument says, “I don’t have hard evidence to support my 
conclusion, but it stands to reason that . . . .” In this case, the argument is 
that people like to have as much control over their time as possible. If your 
audience’s commonsense viewpoints match yours, your argument is likely 
to be persuasive. 

• Numerical data. Numerical data — statistics — are generally more persuasive 
than commonsense arguments. 
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Statistics drawn from the personnel literature (McClellan, 201 3) show that, among 
Fortune 500 companies, flextime decreases turnover by 25 to 35 percent among 
employees with young children. 

Notice that the writer states that the study covered many companies, 
not just one or a handful. If the sample size were small, the claim would 
be much less persuasive. (The discussion of logical fallacies later in this 
chapter explains such hasty generalizations.) 

• Examples. An example makes an abstract point more concrete and 
therefore more vivid and memorable. 

Mary Saunders tried for weeks to arrange for child care for her two preschoolers 
that would enable her to start work at 7 a.m., as required at her workplace. The best 
she could manage was having her children stay with a nonlicensed provider. When 
conditions at that provider led to ear infections in both her children, Mary decided 
that she could no longer continue working. 

Examples are often used along with numerical data. The example above 
gives the problem a human dimension, but the argument also requires 
numerical data to show that the problem is part of a pattern, not an 
isolated event. 

• Expert testimony. A message from an expert is more persuasive than the 
same message from someone without credentials. A well-researched 
article on flextime written by a respected business scholar in a reputable 
business journal is likely to be persuasive. When you make arguments, 
you will often cite expert testimony from published sources or interviews 
you have conducted. 

Figure 8.3, excerpts from a white paper published by McAfee, the computer- 
security company, shows a portion of an argument that combines several 
of these types of evidence. A white paper is an argument, typically 10-20 
pages long, that a company’s product or service will solve a technological or 
business challenge in an industry. The readers of white papers are technical 
experts who implement technology and managers who make purchasing 
decisions. 

CONSIDERING OPPOSING VIEWPOINTS 

When you present an argument, you need to address opposing points of 
view. If you don’t, your opponents will conclude that your proposal is flawed 
because it doesn’t address problems that they think are important. In meet- 
ing the skeptical or hostile reader’s possible objections to your case, you can 
use one of three tactics, depending on the situation: 

• The opposing argument is based on illogical reasoning or on inaccurate or 
incomplete facts. You can counter the argument that flextime increases 
utility bills by citing unbiased research studies showing that it does not. 

• The opposing argument is valid but is less powerful than your own. If you 

can show that the opposing argument makes sense but is outweighed 
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This white paper was written by 
Dmitri Alperovitch, McAfee's Vice 
President for Threat Research. A 
highly regarded security expert, 
Alperovitch has won numerous 
awards, including selection in 2013 
as one of MIT Technology Review's 
Top 35 Innovators Under 35. This first 
paragraph, with its use of Tand the 
references to projects with which 
Alperovitch is associated, presents 
him as an expert. The logic is that if 
he thinks these security threats are 
credible, you should, too. 

Paragraph 2 presents a series of 
examples of what the writer calls an 
"unprecedented transfer of wealth." 


Why haven't we heard more about 
this transfer of wealth? The writer 
answers the question using com- 
monsense evidence: we haven't 
heard about it because victims of 
these security attacks keep quiet, 
fearing that the bad publicity will 
undermine the public's trust in 
them. 


The writer presents additional 
examples of the nature and scope 
of the attacks. In the rest of the 
14-page white paper, he presents 
statistics and examples describ- 
ing the 71 attacks that he is calling 
Operation Shady RAT. The evidence 
adds up to a compelling argument 
that the threat is real and serious, 
and McAfee is the organization you 
should trust to help you protect 
yourself from it. 


FIGURE 8.3 Using 
Different Types of 
Evidence in an Argument 

From Dmitri Alperovitch, Vice President, 
Threat Research, McAfee, "Revealed: 
Operation Shady RAT" white paper. 
Copyright © 201 1 McAfee, Inc. Reprinted 
by permission. 


Having investigated intrusions such as Operation Aurora and NightDragon (the 
systemic long-term compromise of Western oil and gas industry), as well as numerous 
others that have not been disclosed publicly, I am convinced that every company in 
every conceivable industry with significant size and valuable intellectual property 
and trade secrets has been compromised (or will be shortly), with the great majority 
of the victims rarely discovering the intrusion or its impact. In fact, I divide the entire 
set of Fortune Global 2,000 firms into two categories: those that know they've been 
compromised and those that don't yet know. 

What we have witnessed over the past five to six years has been nothing short of 
a historically unprecedented transfer of wealth — closely guarded national secrets 
(including those from classified government networks), source code, bug databases, 
email archives, negotiation plans and exploration details for new oil and gas field 
auctions, document stores, legal contracts, supervisory control and data acquisition 
(SCADA) configurations, design schematics, and much more has "fallen off the truck" of 
numerous, mostly Western companies and disappeared in the ever-growing electronic 
archives of dogged adversaries. 

What is happening to all this data — by now reaching petabytes as a whole — is still 

largely an open question Yet, the public (and often the industry) understanding 

of this significant national security threat is largely minimal due to the very limited 
number of voluntary disclosures by victims of intrusion activity compared to the actual 
number of compromises that take place. With the goal of raising the level of public 
awareness today, we are publishing the most comprehensive analysis ever revealed of 
victim profiles from a five-year targeted operation by one specific actor — "Operation 
Shady RAT, "as I have named it at McAfee (RAT is a common acronym in the industry that 
stands for remote access tool). 

McAfee has gained access to one specific command and control (C&C) server used by 
the intruders. We have collected logs that reveal the full extent of the victim population 
since mid-2006 when the log collection began. Note that the actual intrusion activity may 
have begun well before that time, but that is the earliest evidence we have for the start 
of the compromises. The compromises themselves were standard procedure for these 
types of targeted intrusions: a spear-phishing email containing an exploit is sent to an 
individual with the right level of access at the company, and the exploit, when opened, 
on an unpatched system will trigger a download of the implant malware. That malware 
will execute and initiate a backdoor communication channel to the C&C Web server and 
interpret the instructions encoded in the hidden comments embedded in the Web page 
code. This will be quickly followed by live intruders jumping on to the Infected machine 
and proceeding to quickly escalate privileges and move laterally within the organization 
to establish new persistent footholds via additional compromised machines running 
implant malware, as well as targeting for quick exfiltration the key data they came for. 

After painstaking analysis of the logs, even we were surprised by the enormous 
diversity of the victim organizations and were taken aback by the audacity of the 
perpetrators. Although we will refrain from explicitly identifying most of the victims, 
describing only their general industry, we feel that naming names is warranted in 
certain cases, not with the goal of attracting attention to a specific victim organization, 
but to reinforce the fact that virtually everyone is falling prey to these intrusions, 
regardless of whether they are the United Nations, a multinational Fortune 100 
company, a small, non-profit think tank, a national Olympic team, or even an 
unfortunate computer security firm. 
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by your own argument, you will appear to be a fair-minded person who 
understands that reality is complicated. You can counter the argument that 
flextime reduces carpooling opportunities by showing that only 3 percent of 
your employees currently use carpooling and that three-quarters of these 
employees favor flextime anyway because of its other advantages. 

• The two arguments can be reconciled. If an opposing argument is not 
invalid or clearly inferior to your own, you can offer to study the situation 
thoroughly to find a solution that incorporates the best from each 
argument. For example, if flextime might cause serious problems for your 
company’s many carpoolers, you could propose a trial period during which 
you would study several ways to help employees find other carpooling 
opportunities. If the company cannot solve the problem or if most of 
the employees prefer the old system, you would switch back to it. This 
proposal can remove much of the threat posed by your ideas. 

When you address an opposing argument, be gracious and understated. 
Focus on the argument, not on the people who oppose you. If you embarrass 
or humiliate them, you undermine your own credibility and motivate your 
opponents to continue opposing you. 

There is no one best place in your document to address opposing argu- 
ments. In general, however, if you know that important readers hold oppos- 
ing views, address those views relatively early. Your goal is to show all your 
readers that you are a fair-minded person who has thought carefully about 
the subject and that your argument is stronger than the opposing arguments. 

APPEALING TO EMOTIONS RESPONSIBLY 

Writers sometimes appeal to the emotions of their readers. Writers usu- 
ally combine emotional appeals with appeals to reason. For example, an 
argument that we ought to increase foreign aid to drought-stricken Afri- 
can countries might describe (and present images of) the human plight of 
the victims but also include reason-based sections about the extent of the 
problem, the causes, the possible solutions, and the pragmatic reasons we 
might want to increase foreign aid. 

When you use emotional appeals, do not overstate or overdramatize them, 
or you will risk alienating readers. Try to think of additional kinds of evidence 
to present that will also help support your claim. Figure 8.4 shows a brief 
argument that relies on an emotional appeal. 

DECIDING WHERE TO PRESENT THE CLAIM 

In most cases, the best place to state your claim is at the start of the argument. 
Then provide the evidence and, if appropriate, the reasoning. Sometimes, how- 
ever, it is more effective to place the claim after the evidence and the reason- 
ing. This indirect structure works best if a large number of readers oppose your 
claim. If you present your claim right away, these readers might become alien- 
ated and stop paying attention. You want a chance to present your evidence 
and your reasoning without causing this kind of undesirable reaction. 
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This excerpt from the Army recruit- 
ment site, GoArmy.com, describes 
the Drill Sergeant School. 


The photo and the text present 
a reasonable mix of information 
and emotion. The site provides 
facts about how drill sergeants are 
chosen and trained and the respon- 
sibilities they carry. The lives of drill 
sergeants are not always heroic 
and romantic; they have to teach 
recruits how to make their beds, 
for instance. But the discussion is 
clearly meant to appeal to the emo- 
tions of people who are considering 
joining the Army with the goal 
of becoming drill sergeants. The 
passage repeatedly refers to drill 
sergeants as being "the best."Only 
a select few NCOs can become drill 
sergeants. They become role mod- 
els, carrying themselves with pride. 


Everyone likes to think of himself 
or herself as a special person doing 
an important job. As long as the 
facts that accompany an emotional 
appeal are accurate and presented 
honestly, an emotional appeal is 
responsible. 


FIGURE 8.4 An 

Argument Based on 
an Emotional Appeal 

Source: GoArmy.com, 201 3: www. 
goarmy.com/soldier-life/being-a-soldier 
/ongoing-training/specialized-schools 
/drill-sergeant-school.html. 



DRILL SERGEANT SCHOOL 

To Become A Drill Sergeant, You Always Have To Be "Squared Away" 

A spot in Drill Sergeant School. It's one of the highest honors the U.S. Army can bestow 
a Non-Commissioned Officer (NCO). Only the most qualified NCOs are chosen to attend 
Drill Sergeant School, where they are trained to fulfill a role of utmost importance — the 
role of a Drill Sergeant. After all, Drill Sergeants teach new recruits every aspect of Basic 
Combat Training — which means they have the great responsibility of shaping recruits 
into the best Soldiers in the world. 

NCOs who attend Drill Sergeant School are called Drill Sergeant Candidates. Their 
training is strenuous. The School's curriculum mimics Basic CombatTraining, week for 
week, because Candidates must be experts in all facets of BCT to begin training recruits. 
They receive top-notch training from their Drill Sergeant Instructors because they'll 
soon be expected to deliver great training. 

The "Ultimate Job" For A Sergeant 

For many Candidates, becoming a Drill Sergeant is a "military dream." It means they 
have proven themselves again and again — so much so that they're entrusted with 
training new recruits. They know that when they receive their Drill Sergeant hat, they'll 
have the ultimate job — being a role model — and they take it very seriously. 

More Than Just A Unique Hat 

Earning the Drill Sergeant's hat is not easy. When NCOs are tapped to attend Drill 
Sergeant School, they know they'll have to be able to teach new recruits the proper 
way to do absolutely everything in the Army — from making a bed, to wearing a 
uniform, to firing a rifle. They will have to become the best, because U.S. Army recruits 
deserve to learn from the best. In the end, Drill Sergeants are instantly recognizable. 

Not only because of their unique hat, but also because of the way they speak with 
authority and carry themselves with utmost pride. 
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DOCUMENT ANALYSIS ACTIVITY 


Analyzing Evidence in an Argument 


In this excerpt from an article 
on the job service Monster 
.com, the writer presents an 
argument about hiring a social- 
media officer. The questions 
below ask you to consider the 
nature of the evidence this 
writer presents. 

1. In the first two paragraphs, 
the writer tells a story. Which 
kind of evidence is this, and 
how effective is it? 

2 . In paragraph 3, we learn the 
occupation of the person on 
that unpleasant flight. How 
does this new information 
add to the effectiveness of 
the argument? 

3 . Paragraph 4 begins with the 
words "Let's face it." What 
kind of evidence do you 
expect to see after a phrase 
such as that? 


From Emily Bennington, "Social Media Strategy: Is it Time to Hire a Social Media Officer?" from Monster.com. Reprinted by per- 
mission. Copyright 201 4 - Monster Worldwide, Inc. All Rights Reserved. You may not copy, reproduce or distribute this article 
without the prior written permission of Monster Worldwide. This article first appeared on Monster, the leading online global 
network for careers. To see other career-related articles visit http://career-advice.monster.com. 


Social Media Strategy: Is It Time to Hire a Social Media Officer? 

When Ted Rubin (@tedrubin) touched down in Asheville, NC after a 
particularly unpleasant flight with a carrier he rarely uses, he immediately 
posted an update to his 54,000 Twitter followers. "Just landed ... boy do I 
miss @JetBlue." 


A few minutes later, a representative from Jet Blue responded to say 
thanks. While Rubin tagged the other airline in his original tweet, he never 
heard back from them. "Guess who I'll be flying next?" he laughs. 

Rubin, who serves as Chief Social Marketing Officer for the shopping Web 
site Collective Bias , says this type of personal engagement isn't a novelty 
anymore — customers have come to expect it. "Social media is way deeper 
than most companies understand," he says. "It's time to recognize that 
social isn't just campaign-based, it's an integrated part of your ongoing 
business strategy." 

Let's face it — your social media strategy is about more than monitoring 
— it touches customer service, vendor relations, social media 
recruiting and more. Thus many organizations are bringing in new staff to 
handle their social media strategy. 
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UNDERSTANDING THE ROLE OF CULTURE IN PERSUASION 

For more about writing for people If you are making a persuasive argument to readers from another culture, 

from other cultures, seeCh. 5, p. ioi. keep in mind that cultures differ significantly not only in matters such as 

business customs but also in their most fundamental values. These differ- 
ences can affect persuasive writing. Culture determines both what makes an 
argument persuasive and how arguments are structured: 

• What makes an argument persuasive. Statistics and experimental data are 
fundamental kinds of evidence in the West, but testimony from respected 
authority figures can be much more persuasive in the East. 

• How to structure an argument. In a Western culture, the claim is usually 
presented up front. In an Eastern culture, it is likely to be delayed or to 
remain unstated but implied. 

When you write for an audience from another culture, use two techniques: 

• Study that culture, and adjust the content, structure, and style of your 
arguments to fit it. 

• Include in your budget the cost of having important documents reviewed 
and edited by a person from the target culture. Few people are experts on 
cultures other than their own. 


Avoiding Logical Fallacies 

A logical fallacy — that is, a mistake in reasoning — can undercut the persua- 
siveness of your writing. An example is “Antidepressants are a scam; I know 
that because Tom Cruise says so, and he’s a world-famous actor.” Although 
Tom Cruise is a world-famous actor, it does not follow that what he thinks 
about antidepressants is true. Table 8.1 explains some of the most common 
logical fallacies. 


TABLE 8.1 Common Logical Fallacies 


FALLACY 

EXPLANATION 

EXAMPLE AND COMMENT 

Ad hominem argument; also 
called argument against the 
speaker 

An argument against the 
writer, not against the 
writer's argument 

"Of course Matthew wants us to buy more computers — he's a 
computer geek." 

The fact that Matthew is a "computer geek" doesn't necessarily 
mean that his argument for buying more computers is unwise. 

Argument from ignorance 

An argument that a claim 
is true because it has never 
been proven false, or false 
because it has never been 
proven true 

"Nobody has ever proven that global warming is occurring. 
Therefore, global warming is a myth." 

The fact that a concept has not yet been proven does not 
necessarily mean that it is false. Perhaps the measurement 
techniques are insufficiently precise or not yet available. 


( continued ) 
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1 TABLE 8.1 Common Logical Fallacies (continued) 


FALLACY 

EXPLANATION 

EXAMPLE AND COMMENT 

Appeal to pity 

An argument based on 
emotion, not reason 

"We shouldn't sell the Ridgeway division. It's been part of the 
company for over 40 years." 



The fact that the division has long been a part of the company is 
not in itself a good reason to retain it. 

Argument from authority 

An argument that a claim 
is valid because the person 
making the claim is an 
authority 

"According to world-renowned climatologist Dr. William Smith, 
global warming is definitely a fact." 

Even if Dr. Smith is a recognized authority in this field, the claim 
that global warming is a fact is not valid unless you present a 
valid argument to support it. 

Circular argument 

An argument that restates 
its main point without 
presenting any evidence to 
support it 

"Facebook's stock price keeps falling because the company's 
value is still going down." 

Because a company's stock price is a measure of the company's 
value, the argument simply says that Facebook's stock price 
keeps falling because its stock price keeps falling. Using the word 
because doesn't necessarily mean that the writer has presented 
a reason. The writer needs to explain why the stock price keeps 
going down. 

Either-or argument 

An argument that poses only 
two alternatives when in fact 
there might be more 

"Either we start selling our products online or we're going to be 
out of business within a year." 

This statement does not explain why these are the only two 
alternatives. The company might improve its sales by taking 
measures other than selling online. 

Ad populum argument; also 
called bandwagon argument 

An argument that a claim is 
valid because many people 
think it is or act as if it is 

"Our four major competitors have started selling online so we 
should, too." 

The fact that our competitors are selling online is not in itself an 
argument that we should sell online, too. 

Hasty generalization; 
sometimes called inadequate 
sampling 

An argument that draws 
conclusions based on an 
insufficient number of cases 

"The new Tata is an unreliable car. Two of my friends own Tatas, 
and both have had reliability problems." 

To reach any valid conclusions, you would have to study a much 
larger sample and compare your findings with those for other 
cars in the Tata's class. 

Post hoc reasoning (the 
complete phrase is post hoc, 
ergo propter hoc) 

An argument that claims 
that because A precedes B, A 
caused B 

"There must be something wrong with the new circuit breaker 
in the office. Ever since we had it installed, the air conditioners 
haven't worked right." 



Maybe the air conditioners are malfunctioning because of the 
circuit breaker, but the malfunction might have other causes. 

Oversimplifying 

An argument that omits 
important information in 
establishing a causal link 

"The way to solve the balance-of-trade problem is to improve 
the quality of the products we produce." 

Although improving quality is important, international trade 
balances are determined by many factors, including tariffs and 
currency rates, and therefore cannot be explained by simple 
cause-and-effect reasoning. 





184 


8 


COMMUNICATING PERSUASIVELY 


Presenting Yourself Effectively 

No matter how strong your arguments, your audience won’t read them — or 
won’t read them sympathetically — unless they see you as a professional. 


4 \ 


GUIDELINES 


Creating a Professional Persona 


Your persona is how you appear to your readers. Demonstrating the following four 
characteristics will help you establish an attractive professional persona. 


► Cooperativeness. Make clear that your goal is to solve a problem, not to advance 
your own interests. 

► Moderation. Be moderate in your judgments. The problem you are describing 
will not likely spell doom for your organization, and the solution you propose will 
not solve all the company's problems. 

► Fair-mindedness. Acknowledge the strengths of opposing points of view, even 
as you offer counterarguments. 

► Modesty. If you fail to acknowledge that you don't know everything, someone 
else will be sure to volunteer that insight. 


The following paragraph shows how a writer can demonstrate the quali- 
ties of cooperativeness, moderation, fair-mindedness, and modesty: 


In the first three sentences, the 
writer acknowledges the problems 
with his recommendation. 

The use of "I think" adds an 
attractive modesty; the recommen- 
dation might be unwise. 

The recommendation itself is 
moderate; the writer does not claim 
that the plan will save the world. 

In the last two sentences, the writer 
shows a spirit of cooperativeness by 
focusing on the company's goals. 


This plan is certainly not perfect. For one thing, it calls for a greater up-front 
investment than we had anticipated. And the return on investment through the first 
three quarters is likely to fall short of our initial goals. However, I think this plan is the 

best of the three alternatives for the following reasons Therefore, I recommend 

that we begin planning immediately to implement the plan. I am confident that 
this plan will enable us to enter the 3-D market successfully, building on our fine 
reputation for high-quality advanced electronics. 


ETHICS NOTE 


SEEMING HONEST VERSUS BEING HONEST IN PERSUASIVE WRITING 


The young actor asks the old actor, "What's the key to great acting?" The old actor replies, 
"Sincerity. Once you learn how to fake sincerity Any discussion of image and persuasion 
has to address the question at the heart of this old joke. Does a writer have to be honest to 
appear honest? 


There are tricks for appearing honest, and they can work for a while. But the easiest way to 
appear honest is to be honest. As suggested in Chapter 2, you need to tell the truth and not 
mislead your readers. As suggested in Chapter 4, you also need to be cooperative, diplomatic, 
and constructive. And as suggested in this chapter, you need to remember people's broader 
goals: to protect their own security, to achieve recognition, to learn and grow in their profes- 
sional and personal lives, and to connect with others. 
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Using Graphics as Persuasive Elements 

Graphics are fundamentally important in communicating persuasively 
because they help you convey both technical data and nontechnical informa- 
tion. Figure 8.5, for example, shows how a combination of verbal and visual 
techniques can make a persuasive argument. 

Photographs can be used to convey technical evidence, as shown in Figure 8.6. 


At a traffic light in Nehru Place. India— an upscale computer and electronics market in South Delhi— children 
who are trafficked for the purpose of begging work late into the night. Children are forced to beg for long hours, 
commonly beaten by their bosses, and suffer abuse from individuals they encounter as they beg. 



FIGURE 8.5 

Verbal and Visual Tech- 
niques in Persuasion 

Source: U.S. Department of State, 

201 3: www.state.gov/documents 
/organization/21 0737.pdf. 



FIGURE 8.6 A Photo- 
graph Used To Provide 
Technical Information 

Source: National Aeronautics and Space 
Administration, 201 3: http://climate 
.nasa.gov/state_of_flux#lcemelt 
_Alaska14.jpg. 


Images of the same scene at dif- 
ferent times can provide technical 
information about changes in a 
physical environment. On the left is 
a photo of Northwestern Glacier, in 
Alaska, in 1940; on the right is the 
same scene in 2005. 
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A Look at Several Persuasive Arguments 

The following examples of technical communication show how the persua- 
sive elements of an argument differ depending on a writer’s purpose. Figure 
8.7 presents two paragraphs from a student’s job-application letter. 

Figure 8.8, from the website of Skillcrush, shows an effective use of 
testimonials. 


A student writer uses specific 
examples to persuade a prospective 
employer. 

Without making her claim explicit, 
the writer presents evidence that 
she is hardworking and lets the 
prospective employer draw his or 
her own conclusions. 

In listing some of the training 
courses she has taken, the writer 
supports an earlier claim that her 
broad background might be of use 
to her next employer. FIGURE 8.7 Persuading a Prospective Employer 


At Western State University, I have earned 87 credits toward a degree in Technical 
Communication. I have been a full-time student (no fewer than 1 2 credit hours per 
semester) while working full-time for the Northwest Watershed Research Center. 

The four upper-division courses I am taking this semester, including Advanced 
Technical Communication and Technical Editing, are required for the BA in Technical 
Communication. 

In addition to my formal education, I have completed 34 training courses on the 
job. These courses have included diverse topics such as financial management, the 
Fair Labor Standards Act, the Americans with Disabilities Act, career-development 
opportunities in public affairs, and software applications such as MS Office, Quark 
XPress, and RoboHelp. 


If you work for Skillcrush, which describes itself as "an interactive online learning community for creatives, thinkers, and makers," and wish to make the 
point that your service is valuable, you explain why. But your argument is more persuasive if you can also show that others think so, too. These three 
testimonials are enhanced by the use of the company's logos. 


PEOPLE ARE TALKING 

What They Say About Skillcrush: 


The beauty of Skillcrush is how it turns a 
world that outsiders view as either walled 
off or indecipherable, into simple, 
relatable language." 

FaSTCqMPANY 


"Using Skillcrush is like learning from your 
friendly, accessible best girl friend (not 
that it matters — about 2596 of Skillcrush 
users are men)." 

Mashable 


"Skillcrush is teaching the next generation 
of programmers and entrepreneurs. 
[They're] re-shaping the whole discussion 
about how you learn to code and what 
you do with it That's a big deal." 

BUSINESS 

INSIDER 


FIGURE 8.8 Using Testimonials to Make a Persuasive Argument 

Source: Skillcrush, 2014: http://skillcrush.com/about/. Used by permission. 
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Figure 8.9, from the office of the U.S. president, uses text and a graph 
effectively to present persuasive arguments. 


THE CURRENT MINIMUM WAGE 

IS NOT ENOUGH FOR WORKERS 
AND THEIR FAMILIES TO GET 
OUT OF POVERTY 



Annual minimum wage earnings and poverty line for families of 
two to four, 1964-2013 (2013 dollars) 


#RaiseTheWage 


FIGURE 8.9 Using Text and Graphics to Present a Persuasive Argument 

Source: Whitehouse.gov, 2014: http://www.whitehouse.gov/share/current-minimum-wage-isn-t-enough-workers-get-out 
-poverty. 




188 


8 


COMMUNICATING PERSUASIVELY 


Figure 8.10, half of a brochure from a federal program called STOPfakes, 
shows the importance of presenting a professional image in an argument. 


In this excerpt, the left-hand panel uses 
statistics and commonsense evidence to make 
the case that intellectual-property (IP) owners 
should take reasonable measures to protect 
their intellectual property. The federal STOP- 
fakes program is intended to help them do so. 


The middle panel, which will be the back of 
the brochure when it is folded, briefly describes 
the mission of STOPfakes and provides contact 
information so that IP owners can contact the 
organization (including a quick-response code 
to link directly to the organization's site). 


The right-hand panel, the front of the brochure, 
states the subject (protecting your IP rights) 
and type of document (a step-by-step guide). 
The other three panels not shown here present 
the body of the argument: the step-by-step 
instructions. 

Many brochures, like 
this one, are made from 
a single page, folded 
into three panels that 
group information in 
logical categories. Here 
we see the outside of the 
brochure, with the right- 
hand column presenting 
its title page. Brochures 
are distributed not only 
as paper documents but 
also as PDF (portable 
document format) files 
on organizations' 
websites. 

Throughout, the brochure 
projects a professional 
tone, with direct, under- 
stated language convey- 
ing a strong argument, as 
well as a restrained and 
well-organized presenta- 
tion. For these reasons, 
it is likely to succeed in 
motivating IP owners to 
take advantage of the 
program's resources. 



Intellectual Property Rights 

Intellectual property rights OPR) encourage the inno- 
vation and creativity that are fundamental to sus- 
tained economic growth. In 201 0 alone, US. industries 
relying most intensively on Intelectual property (IP) 
accounted for over $5 trillion— or nearly 35% — of U.S. 
gross domestic product (GDP) and 27.1 mfflicn Ameri- 
can jebs. Unfortunately, the global trade in counterfeit 
and pirated goods causes significant US. trade losses 
and threatens innovation, jobs, health, and safety. 

The US. government has expanded efforts to Improve 
the business environment in foreign markets, devel- 
oped numerous free, publicly available resources to 
educate US. companies, and leveraged our interna- 
tional law enforcement relationships to dismantle the 
criminal networks that manufacture and distribute 
fake goods. These efforts underscore our continuing 
commitment to level the placing field for American 
businesses and workers, and to keep consumers safe 

tamers of inteflectual property, by effectively protect- 
ing and enfordng their PR play a critical role in the 
fight against counterfeit and pirated goods. This guide 
is part of an effort to help IP owners take charge of 
their rights. You can get further assistance by calling 
the STOPfakes hotline at 1 -866-999-HALT or visiting 
STOPfakes^yov, an onfine one-stop shop for informa- 
tion about obtaining and enforcing I PR. 



The United States government I aunched 
STOPfakes.gov to provide U 5. rights 
holders with IPR educational resources, 
tools, and program updates. AddtionaDy, 
the web site allows businesses to file 
electronic complaints about I PR -related 
trade problems^ which are answered 
within 10 days by a trade specialist. Rights 
holders may also call 1 -866499-HALT, a 
hotline answered by IPR experts who can 
help U.S. businesses secure and enforce 
their IPR in the U5. and internationally To 
report IPR crimes, call 1 -866-1 PR-2060. 

www.STOPfakes.gov 

IPR Expert Hotline: 1-866-999-HALT 
National IPR Center: 1 -866-IP R-2060 




A PROTECTING 

YOUR INTELLECTUAL 

PROPERTY RIGHTS 


A STEP-BY-STEP GUIDE 


STOPfakes.gov.^ 


FIGURE 8.10 Crafting a Professional Image in a Brochure 

A brochure is a brief document used to provide information or to promote something. Brochures can describe, for 
example, products produced by a small manufacturer of roofing materials, services offered by a new sports-medicine 
clinic, benefits of joining a particular professional organization or community group, or techniques for choosing 
healthy foods and reducing calories. 

Source: STOPfakes.gov, 201 3: www.stopfakes.gov/sites/default/files/990-389_ITA_Stopfakes_brochure_508.pdf. 
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WRITER'S CHECKLIST 


In analyzing your audience, did you consider their broader 
goals of 

CD maintaining security? (p. 171) 

CD achieving recognition? (p. 172) 

□ growing professionally and personally? (p. 172) 

CD staying connected? (p. 172) 

In planning, did you consider the following constraints: 

CD ethical? (p. 174) 

CD legal? (p. 174) 

I political? (p. 174) 

CD informational? (p. 174) 

CD personnel? (p. 174) 

I financial? (p. 174) 

CD time? (p. 175) 

CD format and tone? (p. 175) 

In crafting a persuasive argument, did you 

□ use the three-part structure of claim, evidence, and 
reasoning? (p. 175) 

1 choose appropriate kinds of evidence? (p. 176) 

CD consider opposing viewpoints? (p. 177) 

CD appeal to emotions responsibly? (p. 179) 


CD carefully consider where to present the claim? (p. 179) 

CD consider the role of your readers' culture? (p. 182) 

In writing the argument, did you avoid the following logical 
fallacies: 

CD ad hominem argument? (p. 182) 

CD argument from ignorance? (p. 182) 

I I appeal to pity? (p. 183) 

CD argument from authority? (p. 183) 

CD circular argument? (p. 183) 

CD either-or argument? (p. 183) 

CD ad populum argument? (p. 183) 

CD hasty generalization? (p. 183) 

I ] post hoc reasoning? (p. 183) 

□ oversimplifying? (p. 183) 

In drafting your argument, did you create a persona that is 

□ cooperative? (p. 184) 

CD moderate? (p. 184) 

CD fair-minded? (p. 184) 

I modest? (p. 184) 

CD Did you consider using graphics as persuasive elements? 
(p. 184) 


EXERCISES 


For more about memos, see Ch. 14, p. 372. 

1. Visit the website of a car manufacturer, such as Ford 
(www.ford.com) or Mercedes-Benz (www.mbusa.com). 
Identify the major techniques of persuasion used in 
the words and graphics on the site. For example, what 
claims are made? What types of evidence are used? Is 
the reasoning sound? 

2 . Victory Air has been criticized in the press lately 
because of its new policy of charging an overweight 
passenger for a second seat if he or she cannot fit in 
a single coach seat without his or her body crossing 
the armrest boundary. In a public letter printed on its 
website, Victory used the following evidence as part of 
its defense of its new policy: 


a. In 2003, a commuter plane crashed on takeoff 
from Charlotte, North Carolina, in part due to 
excess weight. We need to be able to require 
that a heavier passenger pay for and use two 
seats in order to keep the plane's total weight 
within acceptable limits for safe operation of 
the plane. 

b. Our policy is not an attempt to increase revenues: if 
there is an available empty seat, we do not charge 
the heavier passenger for a second seat. 

c. Every passenger pays more for a ticket because 
heavier passengers increase fuel consumption. It's 
only fair that heavier passengers pay extra for the 
increased fuel consumption. 
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d. According to a study by the National Transportation 
Safety Board, an overweight passenger squeezed 
into a single coach seat might be a safety risk to 
another passenger or to himself or herself if the 
plane must be evacuated quickly. 

e. The average weight of a passenger climbed from 1 80 
pounds in 1 995 to 1 90 pounds in 2003. Estimates place 
the current average weight at almost 1 95 pounds. 

For each of these five items, write a brief paragraph 
in which you identify the nature of the evidence — 
commonsense argument, numerical data, example, or 
expert testimony — and comment on its effectiveness. If 
you think the evidence is not as effective as it might be, 
what is the problem, and how would you make it more 
effective? 

3. For each of the following claims, write one paragraph 
identifying the logical flaw: 

a. The election couldn't have been fair — I don't know 
anyone who voted for the winner. 

b. It would be wrong to prosecute Allied for age 
discrimination; Allied has always been a great 
corporate neighbor. 

c. The decrease in smoking can be attributed to 
increased restrictions on smoking in public. 

d. Bill Jensen's proposal to create an on-site day-care 
center is just the latest of his harebrained ideas. 

e. Since the introduction of cola drinks at the start 
of the twentieth century, cancer has become the 
second-greatest killer in the United States. Cola 
drinks should be outlawed. 

f. If mutual-fund guru Peter Lynch recommends this 
investment, I think we ought to buy it. 

g. We should not go into the flash-memory market; we 
have always been a leading manufacturer of DRAM. 

h. The other two hospitals in the city have 
implemented computerized patient record keeping; 

I think we need to do so, too. 


i. Our Model X500 didn't succeed because we failed to 
sell a sufficient number of units. 

j. No research has ever established that Internet 
businesses can earn money; they will never succeed. 

4. TEAM EXERCISE Pair with another student for this 

research project on multicultural communication styles. 

Follow these steps: 

a. Working by yourself, enter the name of a country 
and the word business in a search engine. For 
example, enter"Nicaragua business." Find the 
website of a business in that country, and then print 
out the About the Company page or some similar 
page, such as Mission or Projects. Or enter the name 
of a country and the word government, such as 
"Nicaragua government." Find a government agency 
in that country that has published a report available 
on the Internet. Print several pages of the report. 

b. On your copy of the pages you have printed, 
disguise the country of origin by blacking out the 
name of the company or government agency and 
any other information that would indicate the 
country of origin. 

c. Exchange pages with your partner. Study your 
partner's pages. Do the pages show a different 
strategy of persuasion than you would expect from a 
U.S. writer? For instance, does the writer support his 
or her claims with the kinds of evidence you would 
expect to see in the United States? Is the information 
organized as you would expect? Does the writer 
create a persona that you would expect to see? 

d. Meet with your partner and explain to him or 
her what you see in the pages that is similar to 
or different from what you would expect if the 
document came from the United States. Ask your 
partner whether he or she saw the same things. 
Present your findings in a memo to your instructor. 


For more practice with the concepts covered in this chapter, 
complete the LearningCurve activity "Communicating 
Persuasively" under "Additional Resources" in Ch. 8: 

macmillanhighered.com/launchpad/techcomm1 1e. 
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CASE 8: Analyzing the Persuasiveness of a Website 



Source: PETA, 2013: 
www.peta.org 
/about/faq/Why 
-does-PETA-use 
-controversial-tactics 
.aspx. Web image 
and text, courtesy 
of People for the 
Ethical Treatment of 
Animals, www 
.peta.org. 


You are interning in the communications department of an animal-rights organization, 
and your supervisor has asked you to put together a survey to gauge public reactions to its 
marketing message. Before you can draft a questionnaire to assess how well the persuasion 
strategies are working, you must analyze the organization's website to determine the 
ways in which it employs persuasion. To get started with your project, go to "Cases" under 
"Additional Resources" in Ch. 8 at macmillanhighered.com/launchpad/techcomm11e. 
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MOST OF US WOULD AGREE that there is too much information for us to 
learn — and not nearly enough time for us to learn it. That is why instant messages 
and microblogs such as Twitter are so popular: we can read them quickly and 
then get on to the next thing. 

But much of what needs to be communicated in the workplace cannot be 
reduced to 1 40 characters or an 8-second video. For instance, a plan to create a 
new interactive corporate website that will enable vendors and customers to do 
business with the company conveniently and securely will require many hallway 
conversations, emails, and meetings — and a number of lengthy documents. 

When you write information longer than a few hundred words, you want to 
help your readers understand what you are writing about and what your main 
point is. You want to help them see how you have organized the information. You 
want to emphasize the most-important information. Doing so helps them find 
that information, understand it, and remember it. Your audience will be able to 
read your document faster and understand it better. And they will be more likely 
to agree with your ideas and view your recommendations positively. 

This chapter discusses a number of techniques to help you emphasize the 
most-important information in your technical documents: writing clear and 
informative titles and headings, using lists, and structuring paragraphs 
effectively. 


Writing Clear, Informative Titles 

The title of a document is crucial because it is your first chance to define 
your subject and purpose for your readers, giving them their first clue to 
whether the document contains the information they need. The title is an 
implicit promise to readers: “This document is about Subject A, and it was 
written to achieve Purpose B.” Everything that follows has to relate clearly 
to the subject and purpose defined in the title; if it doesn’t, either the title is 
misleading or the document has failed to make good on the title’s promise. 

You might want to put off giving a final title to your document until you 
have completed the document, because you cannot be sure that the subject 
and purpose you established during the planning stages will not change. 
However, you should jot down a working title before you start drafting; you 
can revise it later. To give yourself a strong sense of direction, make sure the 
working title defines not only the subject of the document but also its pur- 
pose. The working title “Snowboarding Injuries” states the subject but not the 
purpose. “HowTo Prevent Snowboarding Injuries” is better because it helps 
keep you focused on your purpose. 

An effective title is precise. For example, if you are writing a feasibility 
study on the subject of offering free cholesterol screening at your company, 
the title should contain the key terms free cholesterol screening and feasibility. 
The following title would be effective: 


Offering Free Cholesterol Screening at Thrall Associates: A Feasibility Study 
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If your document is an internal report discussing company business, you might 
not need to identify the company. In that case, the following would be clear: 

Offering Free Cholesterol Screening: A Feasibility Study 
Or you could present the purpose before the subject: 

A Feasibility Study of Offering Free Cholesterol Screening 

Avoid substituting general terms, such as health screening for cholesterol 
screening or study for feasibility study; the more precise your terms, the more 
useful your readers will find the title. An added benefit of using precise 
terms is that your document can be more accurately and effectively indexed 
in databases and online libraries, increasing the chances that someone 
researching your subject will be able to find the document. 

Before settling on a title, test its effectiveness by asking whether readers 
will be able to paraphrase it in a clear, meaningful sentence. For instance, 

“A Feasibility Study of Offering Free Cholesterol Screening to Employees of 
Thrall Associates” could be paraphrased as follows: “This document reports 
on a project to determine whether it is feasible to offer free cholesterol 
screening to employees of Thrall Associates.” 

But notice what happens when the title is incomplete: “Free Cholesterol 
Screening.” With only those three words to go on, the reader has to guess 
about the document’s purpose. The reader knows that the document has 
something to do with free cholesterol screening, but is the writer recom- 
mending that screening be implemented, modified, or discontinued? Or is 
the writer reporting on the success of an existing screening program? 

Clear, comprehensive titles can be long. If you need eight or ten words to 
say what you want to say about your subject and purpose, use them. 


Writing Clear, Informative Headings 

Headings, which are lower-level titles for the sections and subsections in 
a document, do more than announce the subject that will be discussed in 
the document. Collectively, they create a hierarchy of information, dividing the 
document into major sections and subdividing those sections into subsec- 
tions. In this way, coherent headings communicate the relative importance 
and generality of the information that follows, helping readers recognize 
major sections as primary (likely to contain more-important or more-general 
information) and subsections as secondary or subordinate (likely to contain 
less-important or more-specific information). 

Clear, informative headings communicate this relationship not only 
through their content but also through their design. For this reason, make 
sure that the design of a primary heading (sometimes referred to as a level 
1 heading, 1 heading, or A heading) clearly distinguishes it from a subordinate 
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heading (a level 2 heading, 2 heading, or B heading), and that the design of that 
subordinate heading clearly distinguishes it from yet a lower level of subordi- 
nate heading (a leuel 3 heading, 3 heading, or C heading). 

The headings used in this book illustrate this principle, as does the exam- 
ple below. Notice that the example uses both typography and indentation 
to distinguish one heading from another and to communicate visually how 
information at one level logically relates to information at other levels. 

Level 1 Heading 

Level 2 Heading 

Level 3 Heading 

The best way to make sure you use typefaces and indentation consistently 
is to use the Styles function. As discussed in Chapter 3, a style is a set of for- 
matting instructions that you can apply to all titles, headings, lists, or other 
design elements that you want to look alike. Because you create a style only 
once but then apply it to any number of headings or other design elements, 
you’re far more likely to format these items consistently than if you were to 
format each one individually. 

Styles also speed up the process of changing the appearance of titles, 
headings, and lists. As you revise, you might notice that two levels of head- 
ings are insufficiently distinct. You can easily use the Styles function to 
change the design of one of those headings so that it is distinct and therefore 
does a better job of helping readers follow the discussion and understand 
where they are in the document. In addition, you can create new styles to 
ensure consistency when, for instance, you further subdivide a subsection of 
a document or introduce bulleted lists into the discussion. 

Because a heading is a type of title, much of the advice about titles in the 
previous section also applies to headings. For instance, a clear, informative 
heading is crucial because it announces the subject and purpose of the dis- 
cussion that follows it, just as a title does for the whole document. Announc- 
ing the subject and purpose in a heading helps readers understand what 
they will be reading or, in some cases, helps them decide whether they need 
to read the section at all. For the writer, a heading eliminates the need for 
awkward transitional sentences such as “Let us now turn to the advantages 
of the mandatory enrollment process” or “The next step in replacing the saw 
blade is to remove the arbor nut from the drive shaft.” 

Effective headings help both reader and writer by forecasting not only 
the subject and purpose of the discussion that follows but also its scope and 
organization. When readers encounter the heading “Three Health Benefits of 
Yoga: Improved Muscle Tone, Enhanced Flexibility, Better Posture,” they can 
reasonably assume that the discussion will consist of three parts (not two or 
four) and that it will begin with a discussion of muscle tone, followed by a 
discussion of flexibility and then posture. 
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TECH TIP 


HowTo Modify and Create Styles 

As you write, you can use the Styles group to modify and cre- 
ate styles to address your specific writing situation. 


1 . To modify a style, right- 
click the style you wish to 
modify in the Styles group 
on the Home tab. Select 
Modify from the drop- _ 
down menu that appears. 

Use the Modify Style / 

dialog box to make changes. 

For additional formatting 
options for elements such as 
fonts, paragraphs, and num- 
bering, select the Format 
button. 

2. To create a new style, apply 
the desired character 
formatting to some text 

or the desired paragraph 
formatting to a paragraph. <'•*« 
Next, select the desired '*>- * 

text or paragraph and 
then right-click it. 

Choose Styles and then 
Save Selection as a 

|5 

New Quick Style. , 

H 
H 


AiBbCcDc 
1 Normal 

AaBbCccx AaBbCi i . W 
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Add Gallery to Quick Access Toolbar 



» < 
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Aab tjfl&cc 
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Use the Create New Style from Formatting dialog box to 
name your new style. Apply additional formatting to the 
style by selecting the Modify button. 


3. You can also create a new style by 
selecting the Styles dialog box ' 
launcher and then selecting the ' 

, New Style button. Use the dialog \ 
/ box that appears to create a new 
/ style. 
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KEYWORDS: styles group, quick styles, create new quick styles, 
modify styles, new styles 


Because headings introduce text that discusses or otherwise elaborates 
on the subject defined by the heading, avoid back-to-back headings. In other 
words, avoid following one heading directly with another heading: 

3. Approaches to Neighborhood Policing 
3.1 Community Policing 

According to the COPS Agency (a component of the U.S. Department of Justice), 
"Community policing focuses on crime and social disorder.". . . 

What’s wrong with back-to-back headings? First, they’re illogical. If your 
document contains a level 1 heading, you have to say something at that level 
before jumping to the discussion at level 2. Second, back-to-back headings 
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distract and confuse readers. The heading “3. Approaches to Neighborhood 
Policing” announces to readers that you have something to say about neigh- 
borhood policing — but you don’t say anything. Instead, another, subordinate 
heading appears, announcing to readers that you now have something to say 
about community policing. 

To avoid confusing and frustrating readers, separate the headings with 
text, as in this example: 

3. Approaches to Neighborhood Policing 

Over the past decade, the scholarly community has concluded that community 
policing offers significant advantages over the traditional approach based on 
patrolling in police cars. However, the traditional approach has some distinct 
strengths. In the following discussion, we define each approach and then explain 
its advantages and disadvantages. Finally, we profile three departments that have 
successfully made the transition to community policing while preserving the major 
strengths of the traditional approach. 

3.1 Community Policing 

According to the COPS Agency (a component of the U.S. Department of Justice), 

"Community policing focuses on crime and social disorder.". . . 

The text after the heading “3. Approaches to Neighborhood Policing” is called 
an advance organizer. It indicates the background, purpose, scope, and organi- 
zation of the discussion that follows it. Advance organizers give readers an 
overview of the discussion’s key points before they encounter the details in 
the discussion itself. 


4 \ 


GUIDELINES 


Revising Headings 


Follow these four suggestions to make your headings more effective. 


► Avoid long noun strings. The following example is ambiguous and hard to 
understand: 


Proposed Production Enhancement Strategies AnalysisTechniques 

Is the heading introducing a discussion of techniques for analyzing strategies 
that have been proposed? Or is it introducing a discussion that proposes using 
certain techniques to analyze strategies? Readers shouldn't have to ask such 
questions. Adding prepositions makes the heading clearer: 

Techniques for Analyzing the Proposed Strategies for Enhancing Production 

This heading announces more clearly that the discussion describes techniques 
for analyzing strategies, that those strategies have been proposed, and that the 
strategies are aimed at enhancing production. It's a longer heading than the 
original, but that's okay. It's also much clearer. 


For more about noun strings, see 
Ch. 10, p.235. 


( continued ) 





198 


9 


EMPHASIZING IMPORTANT INFORMATION 


For more about how to format 
headings, see Ch. 1 1, p. 272. 


► Be informative. In the preceding example, you could add information about how 
many techniques will be described: 

Three Techniques for Analyzing the Proposed Strategies for Enhancing 
Production 

You can go one step further by indicating what you wish to say about the three 
techniques: 

Advantages and Disadvantages of the Three Techniques for Analyzing the 
Proposed Strategies for Enhancing Production 

Again, don't worry if the heading seems long; clarity is more important than 
conciseness. 

► Use a grammatical form appropriate to your audience. The question form works 
well for readers who are not knowledgeable about the subject (Benson, 1985) 
and for nonnative speakers: 

What Are the Three Techniques for Analyzing the Proposed Strategies for 
Enhancing Production? 

The "how-to" form is best for instructional material, such as manuals: 

HowTo Analyze the Proposed Strategies for Enhancing Production 
The gerund form (- ing ) works well for discussions and descriptions of processes: 
Analyzing the Proposed Strategies for Enhancing Production 

► Avoid back-to-back headings. Use advance organizers to separate the headings. 


Writing Clear, Informative Lists 

Technical documents often contain lists. Lists are especially effective in convey- 
ing information that can be itemized (such as three physical conditions that 
frequently lead to patients’ developing adult-onset diabetes). Lists also work 
well for presenting information that can be expressed in a sequence (such as the 
operation of a four-stroke gasoline engine: intake, compression, ignition, exhaust). 

This section explains how to create effective paragraph lists and sentence 
lists. 

WRITE EFFECTIVE PARAGRAPH LISTS 

A paragraph list is a list in which the bulleted or numbered items are para- 
graphs, not merely phrases or sentences. Figure 9.1 shows the same informa- 
tion presented in traditional paragraphs and in a paragraph list. 

For readers, the chief advantage of a paragraph list is that it makes the 
information easier to read and remember. Readers see the structure of the 
discussion — often in a single glance — before they read the details. Once they 
start reading the list, they can more easily follow the discussion because its 
design mirrors its logic. For example, a paragraph-list discussion of the four 
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TRADITIONAL PARAGRAPHS PARAGRAPH LIST 


Although there are several theories of 
human conformity, Kelman's model (1935) is 
still popular. Kelman described three main 
types of conformity. 

The first type of conformity is called 
compliance. A person who conforms out 
of compliance changes his or her behavior 
but not his or her attitudes, thoughts, and 
feelings. In effect, the person is simply 
copying someone else's behavior in order to 
satisfy some external norm. 

The second type of conformity is called 
identification. A person who conforms by 
identification wants to be like that other 
person, but he or she might not yet have 
succeeded in changing his or her attitudes, 
thoughts, and feelings. 

The third type of conformity is called 
internalization. A person who conforms by 
internalization has undergone a complete 
change in public behavior and private 
attitudes, thoughts, and feelings. A member 
of a cult has conformed by internalizing. 


Although there are several theories of 
human conformity, Kelman's model (1 935) is 
still popular. Kelman described three main 
types of conformity: 

• Compliance. A person who conforms 
out of compliance changes his or her 
behavior but not his or her attitudes, 
thoughts, and feelings. In effect, the 
person is simply copying someone else's 
behavior in order to satisfy some external 
norm. 

• Identification. A person who conforms 
by identification wants to be like that 
other person, but he or she might not yet 
have succeeded in changing his or her 
attitudes, thoughts, and feelings. 

• Internalization. A person who conforms 
by internalization has undergone a 
complete change in public behavior and 
private attitudes, thoughts, and feelings. 
A member of a cult has conformed by 
internalizing. 


The author is presenting one model 
of categories of human conformity. 
Creating a paragraph list forces the 
writer to use key words that sharply 
focus each bulleted entry. 

Notice that the writer of the para- 
graph list uses italics to emphasize 
the key term at the start of each 
bullet item. 

Bullet items should be sequenced 
logically. Here, the sequence for the 
three types of conformity is from 
the type in which the person is least 
committed (compliance) to the type 
in which the person is most com- 
mitted (internalization). 

By deleting the wordy topic 
sentences from the traditional para- 
graphs, the writer saves space. The 
list version of the passage is about 
the same length as the paragraph 
version, despite the indentations. 


FIGURE 9.1 Traditional Paragraphs and a Paragraph List 


stages of mitosis (prophase , metaphase, anaphase, telophase ) would arrange the 
stages in the order in which they occur and would use bullets or numbers 
to distinguish one stage from another. As a result, the paragraph-list format 
enables readers to navigate the discussion easily and confidently, if only 
because they can see where the discussion of prophase ends and the discus- 
sion of metaphase begins. 

For you as a writer, turning paragraphs into lists has four advantages: 

• It forces you to look at the big picture. While drafting a document, you 
can easily lose sight of the information outside the paragraph you are 
writing. Turning traditional paragraphs into paragraph lists expands 
your perspective beyond a single paragraph, increasing your chances of 
noticing that an important item is missing or that an item is unclear. It 
also increases the chances that you’ll think more deeply about how items 
and key ideas are related to one another. 

• It forces you to examine the sequence. As you write paragraph lists, you get 
a chance to reconsider whether the sequence of the information is logical. 
Sometimes, the visual dimension that lists add to the text will reveal an 
illogical sequence you might have overlooked in traditional paragraphs. 

• It forces you to create a helpful lead-in. Every list requires a lead-in, or 
introduction to the list; without one, readers are left to guess at how the 
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list relates to the discussion and how the items in the list relate to each 
other. In the lead-in, you can add a number signal that further forecasts 
the content and organization of the material that follows: 

Auto sales declined last year because of four major factors: 

• It forces you to tighten and clarify your prose. When you make a list, you 
look for a word, phrase, or sentence that identifies each item. Your focus 
shifts from weaving sentences together in a paragraph to highlighting key 
ideas, giving you an opportunity to critically consider those key ideas and 
revise accordingly. 

WRITE EFFECTIVE SENTENCE LISTS 

A sentence list is a list in which the bulleted or numbered items are words, 
phrases, or single sentences. Figure 9.2 shows a traditional sentence and a 
list presenting the same information. 

If you don’t have enough space to list the items vertically or if you are not 
permitted to do so, number the items within the sentence: 

We recommend that more work on heat-exchanger performance be done (1 ) with a 
larger variety of different fuels at the same temperature, (2) with similar fuels at different 
temperatures, and (3) with special fuels such as diesel fuel and shale-oil-derived fuels. 


TRADITIONAL SENTENCE SENTENCE LIST 


We recommend that more work on heat- 
exchanger performance be done with a 
larger variety of different fuels at the same 
temperature, with similar fuels at different 
temperatures, and with special fuels such as 
diesel fuel and shale-oil-derived fuels. 


We recommend that more work on heat- 

exchanger performance be done 

• with a larger variety of different fuels at 
the same temperature 

• with similar fuels at different 
temperatures 

• with special fuels such as diesel fuel and 
shale-oil-derived fuels 


FIGURE 9.2 A Traditional Sentence and a Sentence List 


4 \ 


GUIDELINES 


Creating Effective Lists 


These five suggestions will help you write clearer, more effective paragraph lists and 
sentence lists. 


► Set off each listed item with a number, a letter, or a symbol (usually a bullet). 

— Use numbered lists to suggest sequence (as in the steps in a set of instruc- 
tions) or priority (the first item being the most important). Using numbers 


(■ continued ) 
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helps readers see the total number of items in a list. For sublists, use lowercase 
letters: 

1. Item 

a. subitem 

b. subitem 

2. Item 

a. subitem 

b. subitem 

— Use bullets to avoid suggesting either sequence or priority, such as for lists 
of people (everyone except number 1 gets offended). For sublists, use 
dashes. 

• Item 

- subitem 

- subitem 

— Use an open (unshaded) box (□) for checklists. 

► Break up long lists. Because most people can remember only 5 to 9 items easily, 
break up lists of 1 0 or more items. 


ORIGINAL LIST 
Tool kit: 

• handsaw 

• coping saw 

• hacksaw 

• compass saw 

• adjustable wrench 

• box wrench 

• Stillson wrench 

• socket wrench 

• open-end wrench 

• Allen wrench 


REVISED LIST 
Tool kit: 

• Saws 

- handsaw 

- coping saw 

- hacksaw 

- compass saw 

• Wrenches 

- adjustable wrench 

- box wrench 

- Stillson wrench 

- socket wrench 

- open-end wrench 

- Allen wrench 


► Present the items in a parallel structure. A list is parallel if all the items have the 
same grammatical form. For instance, in the parallel list below, each item is a verb 
phrase. 


NONPARALLEL 

Here is the sequence we plan to follow: 

1 . writing of the preliminary proposal 

2. do library research 

3. interview with the Bemco vice president 

4. first draft 

5. revision of the first draft 

6. preparing the final draft 


PARALLEL 

Here is the sequence we plan to follow: 

1. write the preliminary proposal 

2. do library research 

3. interview the Bemco vice president 

4. write the first draft 

5. revise the first draft 

6. prepare the final draft 


► Structure and punctuate the lead-in correctly. The lead-in tells readers how the 
list relates to the discussion and how the items in the list relate to each other. 
Although standards vary from one organization to another, the most common 


For more about designing checklists, 
see Ch. 12, p. 326. 


For more about parallelism, see 
Ch. 10, p.227. 


( continued ) 
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lead-in consists of a grammatically complete clause followed by a colon, as 
shown in the following examples: 

Following are the three main assets: 

The three main assets are as follows: 

The three main assets are the following: 

If you cannot use a grammatically complete lead-in, use a dash or no punctuation 
at all: 

The committee found that the employee 

• did not cause the accident 

• acted properly immediately after the accident 

• reported the accident according to procedures 

► Punctuate the list correctly. Because rules for punctuating lists vary, you should 
find out whether people in your organization have a preference. If not, punctuate 
lists as follows: 

— If the items are phrases, use a lowercase letter at the start. Do not use a period 
or a comma at the end. The white space beneath the last item indicates the 
end of the list. 

The new facility will offer three advantages: 

• lower leasing costs 

• shorter commuting distance 

• a larger pool of potential workers 

— If the items are complete sentences, use an uppercase letter at the start and a 
period at the end. 

The new facility will offer three advantages: 

• The leasing costs will be lower. 

• The commuting distance for most employees will be shorter. 

• The pool of potential workers will be larger. 

— If the items are phrases followed by complete sentences, start each phrase 
with an uppercase letter and end it with a period. Begin the complete sentences 
with uppercase letters and end them with periods. Use italics to emphasize 
the phrases. 

The new facility will offer three advantages: 

• Lower leasing costs. The lease will cost $1,800 per month; currently we pay 
$2,300. 

• Shorter commuting distance. Our workers' average commute of 18 minutes 
would drop to 1 4 minutes. 

• Larger pool of potential workers. In the last decade, the population has 
shifted westward to the area near the new facility. As a result, we would 
increase our potential workforce in both the semiskilled and the managerial 
categories by relocating. 


(■ continued ) 
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— If the list consists of two kinds of items — phrases and complete sentences — 

capitalize each item and end it with a period. 

The new facility will offer three advantages: 

• Lower leasing costs. 

• Shorter commuting distance. Our workers' average commute of 18 minutes 
would drop to 1 4 minutes. 

• Larger pool of potential workers. In the last decade, the population has 
shifted westward to the area near the new facility. As a result, we would 
increase our potential workforce in both the semiskilled and the managerial 
categories by relocating. 

In most lists, the second and subsequent lines, called turnovers, align under the first let- 
ter of the first line, highlighting the bullet or number to the left of the text. This hanging 
indentation helps the reader see and understand the organization of the passage. 


► TECH TIP 


HowTo Create Numbered and Bulleted Lists 


To structure and emphasize information in your document, 
you can format text in a numbered or bulleted list. You can 
create a list by selecting either the Numbering or the Bullets 
button in the Paragraph group or by applying a list style us- 
ing the Styles group. 


Highlight the text you wish to include in a list and then se- 
lect either the Numbering or r~ _ _ " 

the Bullets button in the Para-^"^ ~ ’ i= ' ^ ** 

graph group. ff|S 3 S J5- Jit* I 


H 


You can modify, format, and 
customize your list by using 
the drop-down menu on the 

Numbering or Bullets 

button. 



If you wish to apply the same list style consistently 
throughout your document and make it easy to modify the 
style, you can apply a list style to highlighted text by 
selecting the Styles dialog box launcher and then selecting 
the list style you wish to use. 




Keywords: lists, bullets, numbering 
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EMPHASIZING IMPORTANT INFORMATION 


In many other cultures, headings and lists are considered too informal for 
some documents. Try to find samples written by people from the culture you 
are addressing to examine their use of headings and lists. Consider the fol- 
lowing questions in studying documents from other cultures: 

• How does the writer make the information accessible? That is, how does the 
writer help readers easily find the information they need, without flipping 
through pages or clicking links unnecessarily? 

• How does the writer show the relationship among types of information? Are 

they grouped, highlighted, listed, set off by headings, or set in a typeface 
different from that used for other types of information? When information 
that can be itemized or sequenced is conveyed, what form does the 
itemization or sequencing take? 

• How does the writer communicate to readers the organization of the 
document as a whole and of the parts making up the whole? 

• How does the writer make transitions from one subject to another? As noted 
earlier, a heading eliminates the need for awkward transitional sentences. 
In some cultures, however, the heading itself would be considered 
awkward — and possibly brusque, informal, or disrespectful. 


The first sentence contains the word 
"then" to signal that it introduces a 
summary. 


The final sentence clearly indicates 
the relationship between what 
precedes it and what follows it. 


Writing Clear, Informative Paragraphs 

There are two kinds of paragraphs — body paragraphs and transitional 
paragraphs — both of which play an important role in helping you emphasize 
important information. 

A body paragraph, the basic unit for communicating information, is a group 
of sentences (or sometimes a single sentence) that is complete and self- 
sufficient and that contributes to a larger discussion. In an effective para- 
graph, all the sentences clearly and directly articulate one main point, either 
by introducing the point or by providing support for it. In addition, the whole 
paragraph follows logically from the material that precedes it. 

A transitional paragraph helps readers move from one major point to 
another. Like a body paragraph, it can consist of a group of sentences or be 
a single sentence. Usually it summarizes the previous point, introduces the 
next point, and helps readers understand how the two are related. 

The following example of a transitional paragraph appeared in a discus- 
sion of how a company plans to use this year’s net proceeds. 

Our best estimate of how we will use these net proceeds, then, is to develop a second 
data center and increase our marketing efforts. We base this estimate on our current 
plans and on projections of anticipated expenditures. However, at this time we cannot 
precisely determine the exact cost of these activities. Our actual expenditures may 
exceed what we've predicted, making it necessary or advisable to reallocate the net 
proceeds within the two uses (data center and marketing) or to use portions of the 
net proceeds for other purposes. The most likely uses appear to be reducing short- 
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term debt and addressing salary inequities among software developers; each of these 
uses is discussed below, including their respective advantages and disadvantages. 

STRUCTURE PARAGRAPHS CLEARLY 

Most paragraphs consist of a topic sentence and supporting information. 

The Topic Sentence Because a topic sentence states, summarizes, or 
forecasts the main point of the paragraph, put it up front. Technical com- 
munication should be clear and easy to read, not suspenseful. If a paragraph 
describes a test you performed, include the result of the test in your first 
sentence: 

The point-to-point continuity test on Cabinet 3 revealed an intermittent open circuit 
in the Phase 1 wiring. 

Then go on to explain the details. If the paragraph describes a complicated 
idea, start with an overview. In other words, put the “bottom line” on top: 

Mitosis is the usual method of cell division, occurring in four stages: (1) prophase, 

(2) metaphase, (3) anaphase, and (4) telophase. 

Putting the bottom line on top makes the paragraph much easier to read, as 
shown in Figure 9.3. 

Make sure each of your topic sentences relates clearly to the organiza- 
tional pattern you are using. In a discussion of the physical condition of a 
building, for example, you might use a spatial pattern and start a paragraph 
with the following topic sentence: 

On the north side of Building B, water damage to about 75 percent of the roof 
insulation and insulation in some areas in the north wall indicates that the roof has 
been leaking for some time. The leaking has contributed to . . . 


TOPIC SENTENCE AT THE END TOPIC SENTENCE ATTHE START 

OF THE PARAGRAPH OF THE PARAGRAPH 


A solar panel affixed to a satellite in distant 
geosynchronous orbit receives about 1400 
watts of sunlight per square meter. On Earth, 
cut this number in half, due to the day/night 
cycle. Cut it in half again because sunlight 
hits the Earth obliquely (except exactly 
on the equator). Cut it in half again due to 
clouds and dust in the atmosphere. The 
result: eight times the amount of sunlight falls 
on a solar panel in sun-synchronous orbit as 
falls on the same size area on Earth. 


Eight times the amount of sunlight falls on a 
solar panel in distant geosynchronous orbit 
as falls on the same size area on Earth. A 
solar panel affixed to a satellite in sun- 
synchronous orbit receives about 1 400 watts 
of sunlight per square meter. On Earth, cut 
this number in half, due to the day/night 
cycle. Cut it in half again because sunlight 
hits the Earth obliquely (except exactly 
on the equator). Cut it in half again due to 
clouds and dust in the atmosphere. 


The topic sentences are italicized for 
emphasis in this figure. 

Notice that placing the topic 
sentence at the start gives a focus 
to the paragraph, helping readers 
understand the information in the 
rest of the paragraph. 


FIGURE 9.3 A Topic Sentence Works Better at the Start of the Paragraph 
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Your next paragraph should begin with a topic sentence that continues the 
spatial organizational pattern: 

On the east side of the building, a downspout has eroded the lawn and has caused 
a small silt deposit to form on the neighboring property directly to the east. Riprap 
should be placed under the spout to . . . 

Note that the phrases “on the north side” and “on the east side” signal 
that the discussion is following the points of the compass in a clockwise 
direction, further emphasizing the spatial pattern. Readers can reasonably 
assume that the next two parts of the discussion will be about the south side 
of the building and the west side, in that order. 

Similarly, if your first topic sentence is “First, we need to . . . ,” your next topic 
sentence should refer to the chronological pattern: “Second, we should . . .” (Of 
course, sometimes well-written headings can make such references to the orga- 
nizational pattern unnecessary, as when headings are numbered to emphasize 
that the material is arranged in a chronological pattern.) 


The writer has buried the bad news 
in a paragraph beginning with a 
topic sentence that appears to sug- 
gest good news. The last sentence, 
too, suggests good news. 


Here the writer forthrightly presents 
the bad news in a topic sentence. 
Then he creates a separate para- 
graph with the good news. 


ETHICS NOTE 


AVOIDING BURYING BAD NEWS IN PARAGRAPHS 

The most-emphatic location in a paragraph is the topic sentence, usually the first sentence in a 
paragraph. The second-most-emphatic location is the end of the paragraph. Do not bury bad 
news in the middle of the paragraph, hoping readers won't see it. It would be misleading to 
structure a paragraph like this: 

In our proposal, we stated that the project would be completed by May. In making this 
projection, we used the same algorithms that we have used successfully for more than 14 
years. In this case, however, the projection was not realized, due to several factors beyond 

our control We have since completed the project satisfactorily and believe strongly that 

this missed deadline was an anomaly that is unlikely to be repeated. In fact, we have beaten 
every other deadline for projects this fiscal year. 

A more forthright approach would be as follows: 

We missed our May deadline for completing the project. Although we derived this sched- 
ule using the same algorithms that we have used successfully for more than 1 4 years, 
several factors, including especially bad weather at the site, delayed the construction 

However, we have since completed the project satisfactorily and believe strongly that this 

missed deadline was an anomaly that is unlikely to be repeated In fact, we have beaten 

every other deadline for projects this fiscal year. 


The Supporting Information The supporting information makes the 
topic sentence clear and convincing. Sometimes a few explanatory details 
provide all the support you need. At other times, however, you need a lot of 
information to clarify a difficult thought or to defend a controversial idea. 
How much supporting information to provide also depends on your audience 
and purpose. Readers knowledgeable about your subject may require little 
supporting information; less-knowledgeable readers might require a lot. Like- 
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wise, you may need to provide little supporting information if your purpose 
is merely to state a controversial point of view rather than persuade your 
reader to agree with it. In deciding such matters, your best bet is to be gener- 
ous with your supporting information. Paragraphs with too little support are 
far more common than paragraphs with too much. 

Supporting information, which is most often developed using the basic 
patterns of organization discussed in Chapter 7, usually fulfills one of these 
five roles: 

• It defines a key term or idea included in the topic sentence. 

• It provides examples or illustrations of the situation described in the topic 
sentence. 

• It identifies causes: factors that led to the situation. 

• It defines effects: implications of the situation. 

• It supports the claim made in the topic sentence. 

A topic sentence is like a promise to readers. At the very least, when you 
write a topic sentence that says “Within five years, the City of McCall will 
need to upgrade its wastewater-treatment facilities because of increased 
demands from a rapidly rising population,” you are implicitly promising read- 
ers that the paragraph not only will be about wastewater-treatment facili- 
ties but also will explain that the rapidly rising population is the reason the 
facilities need to be upgraded. If your paragraph fails to discuss these things, 
it has failed to deliver on the promise you made. If the paragraph discusses 
these things but also goes on to speculate about the price of concrete over 
the next five years, it is delivering on promises that the topic sentence never 
made. In both situations, the paragraph has gone astray. 

Paragraph Length How long should a paragraph be? In general, 75 to 125 
words are enough for a topic sentence and four or five supporting sentences. 
Long paragraphs are more difficult to read than short paragraphs because 
they require more focused concentration. They can also intimidate some 
readers, who might skip over them. 

But don’t let arbitrary guidelines about length take precedence over your 
own analysis of the audience and purpose. You might need only one or two 
sentences to introduce a graphic, for example. Transitional paragraphs are 
also likely to be quite short. If a brief paragraph fulfills its function, let it be. 
Do not combine two ideas in one paragraph simply to achieve a minimum 
word count. 

You may need to break up your discussion of one idea into two or more 
paragraphs. An idea that requires 200 or 300 words to develop should prob- 
ably not be squeezed into one paragraph. 

A note about one-sentence paragraphs: body paragraphs and transitional 
paragraphs alike can consist of a single sentence. However, many single- 
sentence paragraphs are likely to need revision. Sometimes the idea in that 
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sentence belongs with the paragraph immediately before it or immediately 
after it or in another paragraph elsewhere in the document. Sometimes the 
idea needs to be developed into a paragraph of its own. And sometimes the 
idea doesn’t belong in the document at all. 

When you think about paragraph length, consider how the information 
will be printed or displayed. If the information will be presented in a narrow 
column, such as in a newsletter, short paragraphs are much easier to read. If 
the information will be presented in a wider column, readers will be able to 
handle a longer paragraph. 


Here are three techniques for dividing long paragraphs. 

► Break the discussion at a logical place. The most logical place to divide this ma- 
terial is at the introduction of the second factor. Because the paragraphs are still 
relatively long and cues are minimal, this strategy should be reserved for skilled 
readers. 

High-tech companies have been moving their operations to the suburbs 
for two main reasons: cheaper, more modern space and a better labor pool. 

A new office complex in the suburbs will charge from one-half to two-thirds 
of the rent charged for the same square footage in the city. And that money 
goes a lot further, too. The new office complexes are bright and airy; new 
office space is already wired for computers; and exercise clubs, shopping 
centers, and even libraries are often on-site. 

The second major factor attracting high-tech companies to the suburbs is 
the availability of experienced labor. Office workers and middle managers are 
abundant. In addition, the engineers and executives, who tend to live in the 
suburbs anyway, are happy to forgo the commuting, the city wage taxes, and 
the noise and stress of city life. 

► Make the topic sentence a separate paragraph and break up the supporting 
information. This version is easier to understand than the one above because the 
brief paragraph at the start clearly introduces the information. In addition, each 
of the two main paragraphs now has a clear topic sentence. 

High-tech companies have been moving their operations to the suburbs 
for two main reasons: cheaper, more modern space and a better labor pool. 

First, office space is a bargain in the suburbs. A new office complex in 
the suburbs will charge from one-half to two-thirds of the rent charged 
for the same square footage in the city. And that money goes a lot further, 
too. The new office complexes are bright and airy; new office space is al- 
ready wired for computers; and exercise clubs, shopping centers, and even 
libraries are often on-site. 

Second, experienced labor is plentiful. Office workers and middle manag- 
ers are abundant. In addition, the engineers and executives, who tend to live 
in the suburbs anyway, are happy to forgo the commuting, the city wage 
taxes, and the noise and stress of city life. 


4 \ 



Dividing Long Paragraphs 


(i continued ) 
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► Use a list. This is the easiest of the three versions for all readers because of the 
extra visual cues provided by the list format. 

High-tech companies have been moving their operations to the suburbs for 
two main reasons: 

• Cheaper, more modern space. Office space is a bargain in the suburbs. A new 
office complex in the suburbs will charge anywhere from one-half to two-thirds 
of the rent charged for the same square footage in the city. And that money 
goes a lot further, too. The new office complexes are bright and airy; new office 
space is already wired for computers; and exercise clubs, shopping centers, and 
even libraries are often on-site. 

• A better labor pool. Office workers and middle managers are abundant. In addition, 
the engineers and executives, who tend to live in the suburbs anyway, are happy to 
forgo the commuting, the city wage taxes, and the noise and stress of city life. 


USE COHERENCE DEVICES WITHIN AND BETWEEN 
PARAGRAPHS 

For the main idea in the topic sentence to be clear and memorable, you need 
to make the support — the rest of the paragraph — coherent. That is, you must 
link the ideas together clearly and logically, and you must express parallel 
ideas in parallel grammatical constructions. Even if the paragraph already 
moves smoothly from sentence to sentence, you can strengthen the coher- 
ence by adding transitional words and phrases, repeating key words, and 
using demonstrative pronouns followed by nouns. 

Adding Transitional Words and Phrases Transitional words and 
phrases help the reader understand a discussion by explicitly stating the 
logical relationship between two ideas. Table 9.1 lists the most common logi- 
cal relationships between two ideas and some of the common transitions 
that express those relationships. 


| TABLE 9.1 

Transitional Words and Phrases ; 

RELATIONSHIP 

TRANSITION 

addition 

also, and, finally, first (second, etc.), furthermore, in addition, 
likewise, moreover, similarly 

comparison 

in the same way, likewise, similarly 

contrast 

although, but, however, in contrast, nevertheless, on the other 
hand, yet 

illustration 

for example, for instance, in other words, to illustrate 

cause-effect 

as a result, because, consequently, hence, so, therefore, thus 

time or space 

above, around, earlier, later, next, soon, then, to the right (left, 
west, etc.) 

summary or conclusion at last, finally, in conclusion, to conclude, to summarize 




210 


9 


EMPHASIZING IMPORTANT INFORMATION 


Transitional words and phrases benefit both readers and writers. When a 
transitional word or phrase explicitly states the logical relationship between 
two ideas, readers don’t have to guess at what that relationship might be. 
Using transitional words and phrases in your writing forces you to think 
more deeply about the logical relationships between ideas than you might 
otherwise. 

To better understand how transitional words and phrases benefit both 
reader and writer, consider the following pairs of examples: 

weak Demand for flash-memory chips is down by 1 5 percent. We have laid off 1 2 
production-line workers. 

improved Demand for flash-memory chips is down by 1 5 percent; as a result, we have 
laid off 1 2 production-line workers. 

weak The project was originally expected to cost $300,000. The final cost was 
$450,000. 

improved The project was originally expected to cost $300,000. However, the final 
cost was $450,000. 

The next sentence pair differs from the others in that the weak example 
does contain a transitional word, but it’s a weak transitional word: 

weak According to the report from Human Resources, the employee spoke 
rudely to a group of customers waiting to enter the store, and he 
repeatedly ignored requests from co-workers to unlock the door so the 
customers could enter. 

improved According to the report from Human Resources, the employee spoke 
rudely to a group of customers waiting to enter the store; moreover, he 
repeatedly ignored requests from co-workers to unlock the door so the 
customers could enter. 

In the weak version, and implies simple addition: the employee did this, 
and then he did that. The improved version is stronger, adding to simple 
addition the idea that refusing to unlock the door compounded the employ- 
ee’s rude behavior, elevating it to something more serious. By using moreover, 
the writer is saying that speaking rudely to customers was bad enough, but 
the employee really crossed the line when he refused to open the door. 

Whichever transitional word or phrase you use, place it as close as possi- 
ble to the beginning of the second idea. As shown in the examples above, the 
link between two ideas should be near the start of the second idea, to provide 
context for it. Consider the following example: 

The vendor assured us that the replacement parts would be delivered in time for the 

product release. The parts were delivered nearly two weeks after the product release, 

however. 

The idea of Sentence 2 stands in contrast to the idea of Sentence 1, but the 
reader doesn’t see the transition until the end of Sentence 2. Put the transi- 
tion at the start of the second idea, where it will do the most good. 
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You should also use transitional words to maintain coherence between 
paragraphs, just as you use them to maintain coherence within paragraphs. 
The link between two paragraphs should be near the start of the second 
paragraph. 

Repeating Key Words Repeating key words — usually nouns — helps read- 
ers follow the discussion. In the following example, the first version could be 
confusing: 

unclear For months the project leaders carefully planned their research. The cost of 

the work was estimated to be over $200,000. 

What is the work: the planning or the research? 

clear For months the project leaders carefully planned their research. The cost of 

the research was estimated to be over $200,000. 

From a misguided desire to be interesting, some writers keep changing 
their important terms. Plankton becomes miniature seaweed, then the ocean’s 
fastfood. Avoid this kind of word game; it can confuse readers. 

Of course, too much repetition can be boring. You can vary nonessential 
terms as long as you don’t sacrifice clarity. 

sluggish The purpose of the new plan is to reduce the problems we are seeing in our 
accounting operations. We hope to see a reduction in the problems by early 
next quarter. 

better The purpose of the new plan is to reduce the problems we are seeing in 

our accounting operations. We hope to see an improvement by early next 
quarter. 

Using Demonstrative Pronouns Followed by Nouns Demonstrative 
pronouns — this, that, these, and those — can help you maintain the coherence 
of a discussion by linking ideas securely. In almost all cases, demonstra- 
tive pronouns should be followed by nouns, rather than stand alone in the 
sentence. In the following examples, notice that a demonstrative pronoun by 
itself can be vague and confusing. 

unclear New screening techniques are being developed to combat viral infections. 
These are the subject of a new research effort in California. 

What is being studied in California: new screening techniques or viral 
infections? 

clear New screening techniques are being developed to combat viral infections. 
These techniques are the subject of a new research effort in California. 

unclear The taskforce could not complete its study of the mine accident. This was 
the subject of a scathing editorial in the union newsletter. 

What was the subject of the editorial: the mine accident or the task force’s 
inability to complete its study of the accident? 

clear The task force failed to complete its study of the mine accident. This failure 
was the subject of a scathing editorial in the union newsletter. 
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Even when the context is clear, a demonstrative pronoun used without a 
noun might interrupt readers’ progress by forcing them to refer back to an 
earlier idea. 

interruptive The law firm advised that the company initiate proceedings. This caused 
the company to search for a second legal opinion. 

fluid The law firm advised that the company initiate proceedings. This advice 

caused the company to search for a second legal opinion. 


DOCUMENT ANALYSIS ACTIVITY 


Identifying the Elements of a Coherent Paragraph 


1 . In what ways does the topic 
sentence function as it 
should? 

2 . Identify the transitional words 
or phrases. How are they used 
effectively? 

3 . Identify the repeated key 
words. How effectively does 
the writer use key words? 

4 . Identify the demonstra- 
tive pronouns followed by 
nouns. How effectively does 
the writer use them? 


The following paragraph is taken from a report published by a water company. In this 
paragraph, the writer is describing how he decided on a method for increasing the 
company's business within his particular branch. (The sentences are numbered.) 

The questions on the left ask you to think about the qualities of coherent paragraphs (as 
outlined on pp. 204-12). 


(1) We found that the best way to improve the Montana branch would be to 
add a storage facility to our existing supply sources. (2) Currently, we can handle 
the average demand on a maximum day; the storage facility will enable us to 
meet peaking requirements and fire-protection needs. (3) In conducting our 
investigation, we considered developing new supply sources with sufficient 
capacity to meet current and future needs. (4) This alternative was rejected, 
however, when our consultants (Smith and Jones) did groundwater studies that 
revealed that insufficient groundwater is available and that the new wells would 
have to be located too far apart if they were not to interfere with each other. 
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WRITER'S CHECKLIST 


Did you revise the title of your document so that it 

EH clearly states the subject and purpose of your 
document? (p. 193) 

□ is precise and informative? (p. 193) 

Did you revise the headings to 

EH avoid long noun strings? (p. 197) 

{ I be informative? (p. 1 98) 

□ use the question form for readers who are not 
knowledgeable about the subject? (p. 1 98) 

□ use the "how-to" form in instructional materials? (p. 198) 

□ use the gerund form [-ing) for the discussion of a 
process? (p. 1 98) 


EH Did you avoid back-to-back headings by including an 
advance organizer? (p. 198) 

EH Did you look for opportunities to turn traditional 
paragraphs into lists? (p. 198) 

Did you revise your paragraphs so that each one 
EH begins with a clear topic sentence? (p. 205) 

EH has adequate and appropriate support? (p. 206) 

□ is not too long for readers? (p. 207) 

□ uses coherence devices such as transitional words and 
phrases, repetition of key words, and demonstrative 
pronouns followed by nouns? (p. 209) 


EXERCISES 


1. Write a one-paragraph evaluation of each of the 
following titles. How clearly does the title indicate the 
subject and purpose of the document? In what ways 
does it fall short of incorporating this chapter's advice 
about titles? On the basis of your analysis, rewrite each 
title. 

a. Recommended Forecasting Techniques for Haldane 
Company 

b. A Study ofTablet Computers 

c. Agriculture in the West: A 10-Year View 

2 . Write a one-paragraph evaluation of each of the 
following headings. How clearly does the heading 
indicate the subject and purpose of the text that will 
follow it? In what ways does it fall short of incorporating 
this chapter's advice about headings? On the basis of 
your analysis, rewrite each heading to make it clearer 
and more informative. Invent any necessary details. 

a. Multigroup Processing Technique Review Board 
Report Findings 

b. The Great Depression of 1929 

c. Electronic Health Records 

3 . Revise the following list so that the lead-in is clear, easy 
to understand, and punctuated correctly. In addition, be 
sure the bullet items are grammatically parallel with one 
another. 


There are several goals being pursued by the Natural 
and Accelerated Bioremediation Research office; 

• the development of cost-effective in situ 
bioremediation strategies for subsurface 
radionuclides and metals; 

• an understanding of intrinsic bioremediation as 
well as accelerated bioremediation using nutrient 
amendments to immobilize contaminants; 

• identifying societal issues associated with 
bioremediation research, and communication 
of bioremediation research findings to 
stakeholders. 

4 . Provide a topic sentence for each of the following 
paragraphs: 

a. . Rising 

health-insurance premiums make American 
businesses less competitive and decrease workers' 
salaries. Health-care costs make up an increasing 
proportion of state and federal budgets, weakening 
the nation's financial outlook, diverting resources 
from other pressing national priorities. Perhaps 
the most important outcome is that millions of 
Americans are priced out of the market, unable 
to afford the health-care services that they 
desperately need to become fully productive in the 
economy. 
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EMPHASIZING IMPORTANT INFORMATION 


b. .The reason for this 

difference is that a larger percentage of engineers 
working in small firms may be expected to hold 
high-level positions. In firms with fewer than 20 
engineers, for example, the median income was 
$62,200. In firms of 20 to 200 engineers, the median 
income was $60,345. For the largest firms, the 
median was $58,600. 

5. In the following paragraph, transitional words and 
phrases have been removed. Add an appropriate 
transition in each blank space. Where necessary, add 
punctuation. 

One formula that appeared foolproof for selling 
computers was direct sales by the manufacturer to the 

consumer. Dell, , climbed to number two 

in PC sales by selling customized products directly on its 

website. , the recent success of Acer, now 

number three in sales, suggests that the older formula 
of distributing commodity items through retailers 
might be best for today's PC industry. Acer's success 
can be attributed to three decisions it made. First, it 
sold off its division that manufactured components 

for other PC brands. , it correctly concluded 

that consumers, who generally prefer preconfigured 


PCs, would outnumber business customers. And 

, it decided to expand its line of inexpensive 

netbooks (small PCs for surfing the Web) just when the 
economic downturn increased the demand for cheaper 
PC products. These decisions appear to have paid off 
for Acer: last year, its market share rose 3 percentage 

points, from 8 to 11. , Dell rose only 0.1 

point, from 14.8 to 14.9. 

6 . In each of the following exercises, the second sentence 
begins with a demonstrative pronoun. Add a noun after 
the demonstrative to enhance coherence. 

a. The Zoning Commission has scheduled an open 

hearing for March 14. This will enable 

concerned citizens to voice their opinions on the 
proposed construction. 

b. The university has increased the number of parking 
spaces, instituted a shuttle system, and increased 

parking fees. These are expected to ease 

the parking problems. 

c. Congress's decision to withdraw support for the 
supercollider in 1994 was a shock to the U.S. particle- 

physics community. This is seen as 

instrumental in the revival of the European research 
community. 


For more practice with the concepts covered in Chapters 7 and 9, 
complete the LearningCurve activity "Organizing and 
Emphasizing Your Information" under "Additional Resources" in Ch. 9: 

macmillanhighered.com/launchpad/techcomm1 1 e. 


CASE 9: Emphasizing Important Information in a Technical Description 


You and two classmates have been asked to write a technical description of a new 3D 
printer purchased by the engineering college at your school. Your professor, however, has 
concerns about the draft you have submitted, and he has outlined those concerns in an 
email. To read the email, identify passages that warrant improvement, and begin revising 
the technical description for emphasis and coherence, go to "Cases" under "Additional 
Resources" in Ch. 9: macmillanhighered.com/launchpad/techcomm11e. 
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IN THE WORKPLACE, it's important to choose words carefully and write 
accurate, clear, concise, correct, and forceful sentences. If a sentence doesn't say 
what you intended, misunderstandings can occur, and misunderstandings cost 
money. More important, the ability to write well — word by word and sentence by 
sentence — reflects positively on you and your organization. If you write well, you 
sound like a professional; you sound like someone worth reading. 


Writing Grammatically Correct Sentences 

Grammar is the study of how words can be combined into sentences to 
make meaning. Why does it matter if you can write grammatically correct 
sentences? One reason is that many grammar conventions are functional. If 
you write, “After sitting on a mildewed shelf in the garage for thirty years, my 
brother decided to throw out the old computer,” you’ve said that your brother 
spent thirty years sitting on a mildewed shelf in the garage, which gave him 
plenty of time to decide what to do with the old computer. If you write, “Did 
Sean tell Liam when he was expected to report to work?” the reader might 
have a hard time figuring out whether he refers to Sean or Liam. 

Even if a grammar mistake doesn’t make you sound silly or confuse the 
reader, it can hurt you by making readers doubt your credibility. The logic is 
that if you are careless about grammar, you might also be careless about the 
quality of the technical information you communicate. Many readers will 
assume that documents that are unprofessional because of grammar prob- 
lems might also be unprofessional in other ways. 

This section will review nine principles for using clear, correct grammar: 

• Avoid sentence fragments. 

• Avoid comma splices. 

• Avoid run-on sentences. 
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• Avoid ambiguous pronoun references. 

• Compare items clearly. 

• Use adjectives clearly. 

• Maintain subject-verb agreement. 

• Maintain pronoun-antecedent agreement. 

• Use tenses correctly. 

AVOID SENTENCE FRAGMENTS 

A sentence fragment is an incomplete sentence. A sentence fragment occurs 
when a sentence is missing either a verb or an independent clause. To correct 
a sentence fragment, use one of the following two strategies: 

1. Introduce a verb. 

fragment The pressure loss caused by a worn gasket. 

This example is a fragment because it lacks a verb. (The word caused does 
not function as a verb here; rather, it introduces a phrase that describes 
the pressure loss.) 

complete The pressure loss was caused by a worn gasket. 

Pressure loss now has a verb: was caused. 
complete We identified the pressure loss caused by a worn gasket. 

Pressure loss becomes the object in a new main clause: We identified the 
pressure loss. 

fragment A plotting program with clipboard plotting, 3D animation, and FFTs. 
complete It is a plotting program with clipboard plotting, 3D animation, and FFTs. 

complete A plotting program with clipboard plotting, 3D animation, and FFTs will be 
released today. 


2. Link the fragment (a dependent element) to an independent clause. 

fragment The article was rejected for publication. Because the data could not be 
verified. 

Because the data could not be verified is a fragment because it lacks an 
independent clause: a clause that has a subject and a verb and could stand 
alone as a sentence. To be complete, the clause needs more information. 

complete The article was rejected for publication because the data could not be 
verified. 

The dependent element is joined to the independent clause that 
precedes it. 

complete Because the data could not be verified, the article was rejected for 
publication. 

The dependent element is followed by the independent clause. 
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FRAGMENT 

Delivering over 1 50 horsepower. The two-passenger coupe will cost over 
$32,000. 

COMPLETE 

Delivering over 1 50 horsepower, the two-passenger coupe will cost over 
$32,000. 

COMPLETE 

The two-passenger coupe will deliver over 1 50 horsepower and cost over 
$32,000. 


AVOID COMMA SPLICES 

A comma splice is an error that occurs when two independent clauses are 
joined, or spliced together, by a comma. Independent clauses in a comma 
splice can be linked correctly in three ways: 

1. Use a comma and a coordinating conjunction (and, or, nor, but, for, so, or 


yet). 


SPLICE 

The 909 printer is our most popular model, it offers an unequaled blend of 
power and versatility. 

CORRECT 

The 909 printer is our most popular model, for it offers an unequaled blend 
of power and versatility. 

The coordinating conjunction for explicitly states the relationship 
between the two clauses. 


2. Use a semicolon. 

splice The 909 printer is our most popular model, it offers an unequaled blend of 


CORRECT 

power and versatility. 

The 909 printer is our most popular model; it offers an unequaled blend of 
power and versatility. 

The semicolon creates a somewhat more distant relationship between 
the two clauses than the comma and coordinating conjunction do; the 
link remains implicit. 


3. Use a period or another form of terminal punctuation. 

splice The 909 printer is our most popular model, it offers an unequaled blend of 


CORRECT 

power and versatility. 

The 909 printer is our most popular model. It offers an unequaled blend of 
power and versatility. 

The two independent clauses are separate sentences. Of the three ways 
to punctuate the two clauses correctly, this one suggests the most distant 
relationship between them. 


AVOID RUN-ON SENTENCES 

In a run-on sentence (sometimes called a fused sentence), two independent 
clauses appear together with no punctuation between them. A run-on sen- 
tence can be corrected in the same three ways as a comma splice: 
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1. Use a comma and a coordinating conjunction (and, or, nor, but, for, so, or yet). 

run-on The 909 printer is our most popular model it offers an unequaled blend of 
power and versatility. 

correct The 909 printer is our most popular model, for it offers an unequaled blend 
of power and versatility. 

2. Use a semicolon. 

run-on The 909 printer is our most popular model it offers an unequaled blend of 
power and versatility. 

correct The 909 printer is our most popular model; it offers an unequaled blend of 
power and versatility. 

3. Use a period or another form of terminal punctuation. 

run-on The 909 printer is our most popular model it offers an unequaled blend of 
power and versatility. 

correct The 909 printer is our most popular model. It offers an unequaled blend of 
power and versatility. 

AVOID AMBIGUOUS PRONOUN REFERENCES 

Pronouns must refer clearly to their antecedents — the words or phrases they 
replace. To correct ambiguous pronoun references, use one of these four 
strategies: 

1. Clarify the pronoun’s antecedent. 

unclear Remove the cell cluster from the medium and analyze it. 

Analyze what: the cell cluster or the medium? 
clear Analyze the cell cluster after removing it from the medium. 
clear Analyze the medium after removing the cell cluster from it. 
clear Remove the cell cluster from the medium. Then analyze the cell cluster. 

clear Remove the cell cluster from the medium. Then analyze the medium. 

2. Clarify the relative pronoun, such as which, introducing a dependent clause. 

unclear She decided to evaluate the program, which would take five months. 

What would take five months: the program or the evaluation? 

clear She decided to evaluate the program, a process that would take five 
months. 

By replacing which with a process that, the writer clearly indicates that it is 
the evaluation that will take five months. 

clear She decided to evaluate the five-month program. 

By using the adjective five-month, the writer clearly indicates that it is the 
program that will take five months. 
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3. Clarify the subordinating conjunction, such as where, introducing a 
dependent clause. 

unclear This procedure will increase the handling of toxic materials outside the 
plant, where adequate safety measures can be taken. 

Where can adequate safety measures be taken: inside the plant or 
outside? 

clear This procedure will increase the handling of toxic materials outside the 
plant. Because adequate safety measures can be taken only in the plant, 
the procedure poses risks. 

clear This procedure will increase the handling of toxic materials outside the 
plant. Because adequate safety measures can be taken only outside the 
plant, the procedure will decrease safety risks. 

Sometimes the best way to clarify an unclear reference is to split the 
sentence in two, drop the subordinating conjunction, and add clarifying 
information. 

4. Clarify the ambiguous pronoun that begins a sentence. 

unclear Allophanate linkages are among the most important structural 

components of polyurethane elastomers. They act as cross-linking 
sites. 

What act as cross-linking sites: allophanate linkages or polyurethane 
elastomers? 

clear Allophanate linkages, which are among the most important structural 
components of polyurethane elastomers, act as cross-linking sites. 

The writer has rewritten part of the first sentence to add a clear 
nonrestrictive modifier and has combined the rewritten phrase with the 
second sentence. 

If you begin a sentence with a demonstrative pronoun that might be 
unclear to the reader, be sure to follow it immediately with a noun that 
clarifies the reference. 

unclear The new parking regulations require that all employees pay for parking 
permits. These are on the agenda for the next senate meeting. 

What are on the agenda: the regulations or the permits? 

clear The new parking regulations require that all employees pay for parking 

permits. These regulations are on the agenda for the next senate meeting. 

COMPARE ITEMS CLEARLY 

When comparing or contrasting items, make sure your sentence commu- 
nicates their relationship clearly. A simple comparison between two items 
usually causes no problems: “The X3000 has more storage than the X2500.” 
Simple comparisons, however, can sometimes result in ambiguous state- 
ments: 
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ambiguous Trout eat more than minnows. 


Do trout eat minnows in addition to other food, or do trout eat more than 
minnows eat? 


CLEAR 


Trout eat more than minnows do. 


If you are introducing three items, make sure the reader can tell which two 
are being compared: 

ambiguous Trout eat more algae than minnows. 


Beware of comparisons in which different aspects of the two items are 
compared: 

illogical The resistance of the copper wiring is lower than the tin wiring. 

logical The resistance of the copper wiring is lower than that of the tin wiring. 


USE ADJECTIVES CLEARLY 

In general, adjectives are placed before the nouns that they modify: the plastic 
washer. In technical communication, however, writers often need to use clus- 
ters of adjectives. To prevent confusion in technical communication, follow 
two guidelines: 

1. Use commas to separate coordinate adjectives. Adjectives that describe 
different aspects of the same noun are known as coordinate adjectives. 

portable, programmable device 
adjustable, removable housings 
The comma is used instead of the word and. 

Sometimes an adjective is considered part of the noun it describes: electric 
drill. When one adjective modifies electric drill, no comma is required: a revers- 
ible electric drill. The addition of two or more adjectives, however, creates the 
traditional coordinate construction: a two-speed, reversible electric drill. 

2. Use hyphens to link compound adjectives. A compound adjective is made 
up of two or more words. Use hyphens to link these elements when com- 
pound adjectives precede nouns. 

a variable-angle accessory 
increased cost-of-living raises 

The hyphens in the second example prevent increased from being read as an 
adjective modifying cost. 


clear 


clear 


Trout eat more algae than they do minnows. 
Trout eat more algae than minnows do. 


Resistance cannot be logically compared with tin wiring. In the revision, 
the pronoun that substitutes for resistance in the second part of the 
comparison. 
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A long string of compound adjectives can be confusing even if you use 
hyphens appropriately. To ensure clarity, turn the adjectives into a clause 
or a phrase following the noun. 

unclear an operator-initiated default-prevention technique 
clear a technique initiated by the operator to prevent default 

MAINTAIN SUBJECT-VERB AGREEMENT 

The subject and verb of a sentence must agree in number, even when a prep- 
ositional phrase comes between them. The object of the preposition might be 
plural in a singular sentence. 

incorrect The result of the tests are promising. 
correct The result of the tests is promising. 

The object of the preposition might be singular in a plural sentence. 

incorrect The results of the test is promising. 
correct The results of the test are promising. 

Don’t be misled by the fact that the object of the preposition and the verb 
don’t sound natural together, as in tests is or test are. Here, the noun test(s) 
precedes the verb, but it is not the subject of the verb. As long as the subject 
and verb agree, the sentence is correct. 

MAINTAIN PRONOUN-ANTECEDENT AGREEMENT 

A pronoun and its antecedent (the word or phrase being replaced by the 
pronoun) must agree in number. Often an error occurs when the antecedent 
is a collective noun — one that can be interpreted as either singular or plural, 
depending on its usage. 

incorrect The company is proud to announce a new stock option plan for their 
employees. 

correct The company is proud to announce a new stock option plan for its employees. 

Company acts as a single unit; therefore, the singular pronoun is appropriate. 

When the individual members of a collective noun are emphasized, however, 
a plural pronoun is appropriate. 

correct The inspection team have prepared their reports. 

correct The members of the inspection team have prepared their reports. 

The use of their emphasizes that the team members have prepared their 
own reports. 

USE TENSES CORRECTLY 

Two verb tenses are commonly used in technical communication: the pres- 
ent tense and the past perfect tense. It is important to understand the spe- 
cific purpose of each. 
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1. The present tense is used to describe scientific principles and recurring 
events. 

incorrect In 1 992, McKay and his coauthors argued that the atmosphere of Mars was 
salmon pink. 

correct In 1 992, McKay and his coauthors argued that the atmosphere of Mars is 
salmon pink. 

Although the argument was made in the historical past — 1992 — the 
point is expressed in the present tense because the atmosphere of Mars 
continues to be salmon pink. 

When the date of the argument is omitted, some writers express the 
entire sentence in the present tense. 

correct McKay and his coauthors argue that the atmosphere of Mars is salmon 
pink. 

2. The past perfect tense is used to describe the earlier of two events that 
occurred in the past. 

correct We had begun excavation when the foreman discovered the burial 
remains. 

Had begun is the past perfect tense. The excavation began before the 
burial remains were discovered. 

correct The seminar had concluded before I got a chance to talk with Dr. Tran. 

Structuring Effective Sentences 

Good technical communication consists of clear, graceful sentences that 
convey information economically. This section describes six principles for 
structuring effective sentences: 

• Emphasize new and important information. 

• Choose an appropriate sentence length. 

• Focus on the “real” subject. 

• Focus on the “real” verb. 

• Use parallel structure. 

• Use modifiers effectively. 

EMPHASIZE NEW AND IMPORTANT INFORMATION 

Sentences are often easier to understand and more emphatic if new informa- 
tion appears at the end. For instance, if your company has labor problems 
and you want to describe the possible results, structure the sentence like 
this: 

Because of labor problems, we anticipate a three-week delay. 

In this case, three-week delay is the new information. 
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If your readers already expect a three-week delay but don’t know the reason 
for it, reverse the structure: 

We anticipate the three-week delay in production because of labor problems. 

Here, the new and important information is labor problems. 

Try not to end the sentence with qualifying information that blunts the 
impact of the new information. 

weak The joint could fail under special circumstances. 

improved Under special circumstances, the joint could fail. 

Put references to time and space at the beginning of the sentence, where 
they can provide context for the main idea that the sentence expresses. 

Since the last quarter of 2014, we have experienced an 8 percent turnover rate in 
personnel assigned to the project. 

On the north side of the building, water from the leaking pipes has damaged the 
exterior siding and the sheetrock on some interior walls. 

CHOOSE AN APPROPRIATE SENTENCE LENGTH 

Sometimes sentence length affects the quality of the writing. In general, an 
average of 15 to 20 words per sentence is effective for most technical com- 
munication. A series of 10-word sentences would be choppy. A series of 
35-word sentences would probably be too demanding. And a succession of 
sentences of approximately the same length would be monotonous. 

In revising a draft, use your software to compute the average sentence 
length of a representative passage. 

Avoid Overly Long Sentences How long is too long? There is no simple 
answer, because ease of reading depends on the vocabulary, sentence struc- 
ture, and sentence length; the reader’s motivation and knowledge of the 
topic; the purpose of the communication; and the conventions of the appli- 
cation you are using. For instance, you use shorter sentences in tweets and 
text messages than in reports. 

Often a draft will include sentences such as the following: 

The construction of the new facility is scheduled to begin in March, but it might be 
delayed by one or even two months by winter weather conditions, which can make it 
impossible or nearly impossible to begin excavating the foundation. 

To avoid creating such long sentences, say one thing clearly and sim- 
ply before moving on to the next idea. For instance, to make this difficult 
40-word sentence easier to read, divide it into two sentences: 

The construction of the new facility is scheduled to begin in March. However, 
construction might be delayed until April or even May by winter weather conditions, 
which can make it impossible or nearly impossible to begin excavating the foundation. 
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Sometimes an overly long sentence can be fixed by creating a list (see the 
Guidelines box in Ch. 9, p. 200). 

Avoid Overly Short Sentences Just as sentences can be too long, they 
can also be too short and choppy, as in the following example: 

Customarily, environmental cleanups are conducted on a"time-and-materials"(T&M) 
basis. Using the T&M basis, the contractor performs the work. Then the contractor 
bills for the hours worked and the cost of equipment and materials used during 
the work. With the T&M approach, spending for environmental cleanups by private 
and government entities has been difficult to contain. Also, actual contamination 
reduction has been slow. 

The problem here is that some of the sentences are choppy and contain too 
little information, calling readers’ attention to how the sentences are con- 
structed rather than to what the sentences say. In cases like this, the best 
way to revise is to combine sentences: 

Customarily, environmental cleanups are conducted on a"time-and-materials"(T&M) 
basis: the contractor performs the work, then bills for the hours worked and the cost 
of equipment and materials. With the T&M approach, spending for environmental 
cleanups by private and government entities has been difficult to contain, and 
contamination reduction has been slow. 

Another problem with excessively short sentences is that they needlessly 
repeat key terms. Again, consider combining sentences: 

sluggish I have experience working with various microprocessor-based systems. 

Some of these microprocessor-based systems include theT90, RCA 9600, 
and AIM 7600. 

better I have experience working with various microprocessor-based systems, 
including theT90, RCA 9600, and AIM 7600. 

FOCUS ON THE"REAL" SUBJECT 

The conceptual, or “real,” subject of the sentence should also be the gram- 
matical subject. Don’t disguise or bury the real subject in a prepositional 
phrase following a weak grammatical subject. In the following examples, 
the weak subjects obscure the real subjects. (The grammatical subjects are 
italicized.) 

weak The use of this method would eliminate the problem of motor damage. 
strong This method would eliminate the problem of motor damage. 

weak The presence of a six-membered lactone ring was detected. 

strong A six-membered lactone ring was detected. 

In revising a draft, look for the real subject (the topic) and ask yourself 
whether the sentence would be more effective if the real subject was also 
the grammatical subject. Sometimes all that is necessary is to ask yourself 
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this question: What is the topic of this sentence? The author of the first example 
above wasn’t trying to say something about using a method; she was trying 
to say something about the method itself. Likewise, in the second example, 
it wasn’t the presence of a lactone ring that was detected; rather, the lactone 
ring itself was detected. 

Another way to make the subject of the sentence prominent is to reduce the 
number of grammatical expletives. Expletives are words that serve a grammati- 
cal function in a sentence but have no meaning. The most common expletives 
are it (generally followed by is) and there (generally followed by is or are). 

weak There is no alternative for us except to withdraw the product. 

strong We have no alternative except to withdraw the product. 

weak It is hoped that testing the evaluation copies of the software will help us 
make this decision. 

strong We hope that testing the evaluation copies of the software will help us 
make this decision. 

For more about using the passive 
voice, see p. 231. 


with the expletive It is hard to say whether the downturn will last more than a 

few months. 

without the expletive Whether the downturn will last more than a few months is 

hard to say. 

The second version is harder to understand because the reader has to remem- 
ber a long subject (Whether the downturn will last more than a few months) before 
getting to the verb (is). Fortunately, you can revise the sentence in other ways 
to make it easier to understand and to eliminate the expletive. 

I don't know whether the downturn will last more than a few months. 

Nobody knows whether the downturn will last more than a few months. 

Use the search function of your word processor to locate both weak sub- 
jects (usually they precede the word of) and expletives (search for it is, there 
is, and there are). 

FOCUS ON THE "REAL" VERB 

A “real” verb, like a “real” subject, should stand out in every sentence. A com- 
mon problem in technical communication is the inappropriate use of a nomi- 
nalized verb — a verb that has been changed into a noun, then coupled with a 
weaker verb. To install becomes to effect an installation ; to analyze becomes to 
conduct an analysis. Notice how nominalizing the verbs makes the following 
sentences both awkward and unnecessarily long (the nominalized verbs are 
italicized). 


The second example uses the expletive it with the passive voice. The problem 
is that the sentence does not make clear who is doing the hoping. 

Expletives are not errors. Rather, they are conversational expressions that 
can clarify meaning by emphasizing the information that follows them. 
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WEAK 


STRONG 


Each preparation of the solution is done twice. 
Each solution is prepared twice. 


WEAK 


Consideration should be given to an acquisition of the properties. 


strong We should consider acquiring the properties. 

Like expletives, nominalizations are not errors. In fact, many common 
nouns are nominalizations: maintenance, requirement, and analysis, for exam- 
ple. In addition, nominalizations often effectively summarize an idea from a 
previous sentence (in italics below). 

The telephone-service provider decided not to replace the land lines that were damaged 
in the recent storm. This decision could prove a real problem for those residents who used 
land lines to connect to the Internet and for their medical-alert services. 

Some software programs search for common nominalizations. With any word 
processor, however, you can identify most of them by searching for character 
strings such as tion, ment, sis, ence, ing, and ance, as well as the word of. 

USE PARALLEL STRUCTURE 

A sentence is parallel if its coordinate elements follow the same grammati- 
cal form: for example, all the clauses are either passive or active, all the verbs 
are either infinitives or participles, and so on. Parallel structure creates a 
recognizable pattern, making a sentence easier for the reader to follow. Non- 
parallel structure creates no such pattern, distracting and possibly confusing 
readers. In the following examples of nonparallel constructions, the verbs are 
not in the same form (verbs are italicized). 

nonparallel Our present system is costing us profits and reduces our productivity. 

parallel Our present system is costing us profits and reducing our productivity. 

nonparallel The compositor should follow the printed directions; do not change 


When using parallel constructions, make sure that parallel items in a 
series do not overlap, causing confusion or even changing the meaning of the 
sentence: 

confusing The speakers will include partners of law firms, businesspeople, and civic 


leaders. 

Partners of appears to apply to businesspeople and civic leaders, as well as to 
law firms. That is, partners 0/ carries over to the other items in the series. 
The following revision solves the problem by rearranging the items so 
that partners can apply only to law firms. 

The speakers will include businesspeople, civic leaders, and partners of law 
firms. 


parallel 


the originator's work. 

The compositor should follow the printed directions and should not 
change the originator's work. 


clear 



228 


10 


WRITING CORRECT AND EFFECTIVE SENTENCES 


confusing We need to buy more lumber, hardware, tools, and hire the subcontractors. 
The writer has linked two ideas inappropriately. The first idea is that we 
need to buy three things: lumber, hardware, and tools. The second is that 
we need to hire the subcontractors. Hiring is not in the same category 
as the items to be bought. In other words, the writer has structured and 
punctuated the sentence as if it contained a four-item series, when in fact 
it should contain a three-item series followed by a second verb phrase. 

clear We need to buy more lumber, hardware, and tools, and we need to hire the 
subcontractors. 

USE MODIFIERS EFFECTIVELY 

Modifiers are words, phrases, and clauses that describe other elements in the 
sentence. To make your meaning clear, you must indicate whether a modi- 
fier provides necessary information about the word or phrase it refers to (its 
antecedent) or whether it simply provides additional information. You must 
also clearly identify the antecedent — the element in the sentence that the 
modifier is describing or otherwise referring to. 

Distinguish Between Restrictive and Nonrestrictive Modifiers As 

the term implies, a restrictive modifier restricts the meaning of its antecedent; 
it provides information that the reader needs to identify the antecedent and 
is, therefore, crucial to understanding the sentence. Notice that restrictive 
modifiers — italicized in the following examples — are not set off by commas: 

The airplanes used in the exhibitions are slightly modified. 

The modifying phrase used in the exhibitions identifies which airplanes the writer is 
referring to. Presumably, there are at least two groups of airplanes: those that are 
used in the exhibitions and those that are not. The restrictive modifier tells readers 
which of the two groups is being discussed. 

Please disregard the notice you recently received from us. 

The modifying phrase you recently received from us identifies which notice. Without it, 
the sentence could be referring to one of any number of notices. 

In most cases, the restrictive modifier doesn’t require a relative pronoun, 
such as that, but you can choose to use the pronoun that (or who, for people): 

Please disregard the notice that you recently received from us. 

A nonrestrictive modifier does not restrict the meaning of its antecedent: 
the reader does not need the information to identify what the modifier is 
describing or referring to. If you omit the nonrestrictive modifier, the basic 
sentence retains its primary meaning. 

The Hubble telescope, intended to answer fundamental questions about the origin of the 
universe, was last repaired in 2002. 

Here, the basic sentence is The Hubble telescope was last repaired in 2002. Removing 
the modifier doesn’t change the meaning of the basic sentence. 
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If you use a relative pronoun with a nonrestrictive modifier, choose which (or 
who or whom for a person). 

Go to the Registration Area, which is located on the second floor. 

Use commas to separate a nonrestrictive modifier from the rest of the sen- 
tence. In the example about the Hubble telescope, a pair of commas encloses 
the nonrestrictive modifier and separates it from the rest of the sentence. In 
that respect, the commas function much like parentheses, indicating that the 
modifying information is parenthetical. In the example about the Registra- 
tion Area, the comma indicates that the modifying information is tacked on 
at the end of the sentence as additional information. 

Avoid Misplaced Modifiers The placement of the modifier often deter- 
mines the meaning of the sentence, as the placement of only in the following 
sentences illustrates: 

Only Turner received a cost-of-living increase last year. 

Meaning: Nobody else received one. 

Turner received only a cost-of-living increase last year. 

Meaning: He didn’t receive a merit increase. 

Turner received a cost-of-living increase only last year. 

Meaning: He received a cost-of-living increase as recently as last year. 

Turner received a cost-of-living increase last year only. 

Meaning: He received a cost-of-living increase in no other year. 

Misplaced modifiers — those that appear to modify the wrong antecedent — 
are a common problem. Usually, the best solution is to place the modifier as 
close as possible to its intended antecedent. 

misplaced The subject of the meeting is the future of geothermal energy in the 
downtown Webster Hotel. 

correct The subject of the meeting in the downtown Webster Hotel is the future of 
geothermal energy. 

A squinting modifier falls ambiguously between two possible antecedents, 
so the reader cannot tell which one is being modified: 

unclear We decided immediately to purchase the new system. 

Did we decide immediately, or did we decide to make the purchase 
immediately? 

clear We immediately decided to purchase the new system. 

clear We decided to purchase the new system immediately. 

A subtle form of misplaced modification can also occur with correlative 
constructions, such as either ... or, neither . . . nor, and not only . . . but also: 


misplaced The new refrigerant not only decreases energy costs but also spoilage losses. 
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Here, the writer is implying that the refrigerant does at least two things 
to energy costs: it decreases them and then does something else to them. 
Unfortunately, that’s not how the sentence unfolds. The second thing the 
refrigerant does to energy costs never appears. 

correct The new refrigerant decreases not only energy costs but also spoilage losses. 

In the revised sentence, the phrase decreases not only implies that at least 
two things will be decreased, and as the sentence develops that turns out to 
be the case. Decreases applies to both energy costs and spoilage losses. There- 
fore, the first half of the correlative construction (not only) follows the verb 
( decreases ). Note that if the sentence contains two different verbs, each half of 
the correlative construction precedes a verb: 

The new refrigerant not only decreases energy costs but also reduces spoilage losses. 


Avoid Dangling Modifiers A dangling modifier has no antecedent in the 
sentence and can therefore be unclear: 

dangling Trying to solve the problem, the instructions seemed unclear. 

This sentence says that the instructions are trying to solve the problem. 

To correct the sentence, rewrite it, adding the clarifying information either 
within the modifier or next to it: 

correct As I was trying to solve the problem, the instructions seemed unclear. 
correct Trying to solve the problem, I thought the instructions seemed unclear. 

Sometimes you can correct a dangling modifier by switching from the 
indicative mood (a statement of fact) to the imperative mood (a request or com- 
mand): 

dangling To initiate the procedure, the BEGIN button should be pushed, (indicative 
mood) 

correct To initiate the procedure, push the BEGIN button, (imperative mood) 

Choosing the Right Words and Phrases 

This section discusses four principles that will help you use the right words 
and phrases in the right places: select an appropriate level of formality, be 
clear and specific, be concise, and use inoffensive language. 

SELECT AN APPROPRIATE LEVEL OF FORMALITY 

Although no standard definition of levels of formality exists, most experts 
would agree that there are three levels: 

informal The Acorn 560 is a real screamer. With 5.5 GHz of pure computing 

power, it slashes through even the thickest spreadsheets before you 
can say 2 + 2 = 4. 
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moderately With its 5.5-GHz microprocessor, the Acorn 560 can handle even 
formal the most complicated spreadsheets quickly. 

highly formal With a 5.5-GHz microprocessor, the Acorn 560 is a high-speed 
personal computer appropriate for computation-intensive 
applications such as large, complex spreadsheets. 

Technical communication usually requires a moderately formal or highly 
formal style. 

To achieve the appropriate level and tone, think about your audience, your 
subject, and your purpose: 

• Audience. You would probably write more formally to a group of retired 
executives than to a group of college students. You would likewise write 
more formally to the company vice president than to your co-workers, 
and you would probably write more formally to people from most other 
cultures than to people from your own. 

• Subject. You would write more formally about a serious subject — safety 
regulations or important projects — than about plans for an office party. 

• Purpose. You would write more formally in presenting quarterly economic 
results to shareholders than in responding to an email requesting sales 
figures on one of the company’s products. 

In general, it is better to err on the side of formality. Avoid an informal 
style in any writing you do at the office, for two reasons: 

• Informal writing tends to be imprecise. In the example “The Acorn 560 is a 
real screamer,” what exactly is a s creamer? 

• Informal writing can be embarrassing. If your boss spots your email to a 
colleague, you might wish it didn’t begin, “’Sup, dawg?” 

BE CLEAR AND SPECIFIC 

Follow these seven guidelines to make your writing clear and specific: 

• Use active and passive voice appropriately. 

• Be specific. 

• Avoid unnecessary jargon. 

• Use positive constructions. 

• Avoid long noun strings. 

• Avoid cliches. 

• Avoid euphemisms. 

Use Active and Passive Voice Appropriately In a sentence using the 
active voice, the subject performs the action expressed by the verb: the “doer” 
of the action is the grammatical subject. By contrast, in a sentence using the 
passive voice, the recipient of the action is the grammatical subject. Compare 
the following examples (the subjects are italicized): 


For more about writing to a 
multicultural audience, see Ch. 5, 

p. 101. 
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For more about ethics, see Ch. 2. 


For more about the use of the passive 
voice in lab reports, see Ch. 1 9, 
p. 520. 


active Dave Brushaw drove the launch vehicle. 

The doer of the action is the subject of the sentence. 
passive The launch vehicle was driven by Dave Brushaw. 

The recipient of the action is the subject of the sentence. 

In most cases, the active voice works better than the passive voice because 
it emphasizes the agent (the doer of the action). An active-voice sentence 
also is shorter because it does not require a form of the verb to be and the 
past participle, as a passive-voice sentence does. In the active version of the 
example sentence, the verb is drove rather than was driven, and the word by 
does not appear. 

The passive voice, however, is generally better in these four cases: 

• When the agent is clear from the context: 

Students are required to take both writing courses. 

Here, the context makes it clear that the college sets the requirements. 

• When the agent is unknown: 

The comet was first referred to in an ancient Egyptian text. 

We don’t know who wrote this text. 

• When the agent is less important than the action: 

The blueprints were hand-delivered this morning. 

It doesn’t matter who the messenger was. 

• When a reference to the agent is embarrassing, dangerous, or in some 
other way inappropriate: 

Incorrect figures were recorded for the flow rate. 

It might be unwise or tactless to specify who recorded the incorrect figures. 

Perhaps it was your boss. However, it is unethical to use the passive voice to avoid 
responsibility for an action. 

The passive voice can also help you maintain the focus of your paragraph. 

Cloud computing offers three major advantages. First, the need for server space is 
reduced. Second, security updates are installed automatically . . . 

Some people believe that the active voice is inappropriate in technical 
communication because it emphasizes the person who does the work rather 
than the work itself, making the writing less objective. In many cases, this 
objection is valid. Why write “I analyzed the sample for traces of iodine” if 
there is no ambiguity about who did the analysis or no need to identify who 
did it? The passive focuses on the action, not the actor: “The samples were 
analyzed for traces of iodine.” But if in doubt, use the active voice. 

Other people argue that the passive voice produces a double ambiguity. In 
the sentence “The samples were analyzed for traces of iodine,” the reader is 
not quite sure who did the analysis (the writer or someone else) or when it 
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was done (during the project or some time previously). Identifying the actor 
can often clarify both ambiguities. 

The best approach is to recognize that the two voices differ and to use 
each one where it is most effective. 

Many grammar-checkers can help you locate the passive voice. Some of 
them will advise you that the passive is undesirable, almost an error, but this 
advice is misleading. Use the passive voice when it works better than the 
active voice for your purposes. 

Any word processor allows you to search for the forms of to be used most 
commonly in passive-voice expressions: is, are, was, and were. You can also 
search for ed to isolate past participles (for example, purchased, implemented, and 
delivered); such past participles appear in most passive-voice constructions. 


Be Specific Being specific involves using precise words, providing adequate 
detail, and avoiding ambiguity. 

• Use precise words. A Ford Focus is an automobile, but it is also a vehicle, a 
machine, and a thing. In describing the Focus, automobile is better than the 
less-specific vehicle, because uehicle can also refer to pickup trucks, trains, hot- 
air balloons, and other means of transport. As words become more abstract — 
from machine to thing, for instance — chances for misunderstanding increase. 

• Provide adequate detail. Readers probably know less about your subject than 
you do. What might be perfectly clear to you might be too vague for them. 

vague An engine on the plane experienced some difficulties. 

Which engine? What plane? What kinds of difficulties? 

clear The left engine on the Cessna 310 temporarily lost power during flight. 

• Avoid ambiguity. Don’t let readers wonder which of two meanings you are 
trying to convey. 

ambiguous After stirring by hand for 10 seconds, add three drops of the iodine mixture 
to the solution. 

After stirring the iodine mixture or the solution? 

clear Stir the iodine mixture by hand for 10 seconds. Then add three drops to 
the solution. 

clear Stir the solution by hand for 10 seconds. Then add three drops of the 
iodine mixture. 

If you don’t have the specific data, you should approximate — and clearly 
tell readers you are doing so — or explain why the specific data are unavail- 
able and indicate when they will be available: 

The fuel leakage is much greater than we had anticipated; we estimate it to be at least 
5 gallons per minute, not 2. 

The fuel leakage is much greater than we had anticipated; we expect to have specific 
data by 4 p.m. today. 
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Avoid Unnecessary Jargon Jargon is shoptalk. To an audiophile, LP is a 
long-playing record; to an engineer, it is liquid propane; to a guitarist, it is a 
Gibson Les Paul model; to a physician, it is a lumbar puncture; to a drummer, 
it is Latin Percussion, a drum maker. 

Jargon is often ridiculed; many dictionaries define it as “writing that one 
does not understand” or “nonsensical, incoherent, or meaningless talk.” 
However, jargon is useful in its proper sphere. For one thing, jargon enables 
members of a particular profession to communicate clearly and economi- 
cally with one another. 

If you are addressing a technically knowledgeable audience, use 
jargon recognized in that field. However, keep in mind that technical 
documents often have many audiences in addition to the primary audi- 
ence. When in doubt, avoid jargon; use more-common expressions or 
simpler terms. 

Using jargon inappropriately is inadvisable for four reasons: 

• It can be imprecise. If you ask a co-worker to review a document and 
provide feedback, are you asking for a facial expression, body language, a 
phone call, or a written evaluation? 

• It can be confusing. If you ask a computer novice to cold swap the drive, he 
or she might have no idea what you’re talking about. 

• It is often seen as condescending. Many readers will react as if you were 
showing off — displaying a level of expertise that excludes them. If readers 
feel alienated, they will likely miss your message. 

• It is often intimidating. People might feel inadequate or stupid because 
they do not know what you are talking about. Obviously, this reaction 
undermines communication. 


Use Positive Constructions The term positive construction has nothing to 
do with being cheerful. It indicates that the writer is describing what some- 
thing is instead of what it is not. In the sentence “I was sad to see this project 
completed,” “sad” is a positive construction. The negative construction would 
be “not happy.” 

Here are a few more examples of positive and negative constructions: 


Positive construction 

most 

few 

on time 

positive 

inefficient 

reject 

impossible 


Negative construction 

not all 
not many 

not late, not delayed 
not negative 
not efficient 
cannot accept 
not possible 
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Readers understand positive constructions more quickly and more easily 
than negative constructions. Consider the following examples: 

difficult Because the team did not have sufficient time to complete the project, it 
was unable to produce a satisfactory report. 

simpler Because the team had too little time to complete the project, it produced 
an unsatisfactory report. 

Avoid Long Noun Strings A noun string contains a series of nouns (or 
nouns, adjectives, and adverbs), all of which together modify the last noun. 
For example, in the phrase parking-garage regulations, the first pair of words 
modifies regulations. Noun strings save time, and if your readers understand 
them, they are fine. It is easier to write passive-restraint system than a system 
that uses passive restraints. 

Hyphens can clarify noun strings by linking words that go together. For 
example, in the phrase flat-panel monitor, the hyphen links flat and panel. 
Together they modify monitor. In other words, it is not aflat panel or a panel 
monitor, but a flat-panel monitor. However, noun strings are sometimes so long 
or so complex that hyphens can’t ensure clarity. To clarify a long noun string, 
untangle the phrases and restore prepositions, as in the following example: 

unclear preregistration procedures instruction sheet update 

clear an update of the instruction sheet for preregistration procedures 

Noun strings can sometimes be ambiguous — they can have two or more 
plausible meanings, leaving readers to guess at which meaning you’re trying 
to convey. 

ambiguous The building contains a special incoming materials storage area. 

What’s special? Are the incoming materials special? Or is the area 
they’re stored in special? 

unambiguous The building contains a special area for storing incoming materials. 

unambiguous The building contains an area for storing special incoming materials. 

An additional danger is that noun strings can sometimes sound pompous. 
If you are writing about a simple smoke detector, there is no reason to call it 
a smoke -detection device or, worse, a smoke-detection system. 

Avoid Cliches Good writing is original and fresh. Rather than use a cliche, 
say what you want to say in plain English. Current cliches include pushing the 
envelope; synergy; mission critical; bleeding edge; paradigm shift; and been there, 
done that. The best advice is to avoid cliches: if you are used to hearing or 
reading a phrase, don’t use it. Jimi Hendrix was a rock star; the Employee of 
the Month sitting in the next cubicle isn’t. Don’t think outside the box, pick 
low-hanging fruit, leverage your assets, bring your “A” game, be a change 
agent, raise the bar, throw anyone under a bus, be proactive, put lipstick on 


For more about hyphens, see 
Appendix, Part C, p. 670. 
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a pig, or give 110 percent. And you can assume that everyone already knows 
that it is what it is. 

Avoid Euphemisms A euphemism is a polite way of saying something 
that makes people uncomfortable. For instance, a near miss between two 
airplanes is officially an “air proximity incident.” The more uncomfortable the 
subject, the more often people resort to euphemisms. Dozens of euphemisms 
deal with drinking, bathrooms, sex, and death. Here are several euphemisms 
for firing someone: 

personnel-surplus reduction dehiring 

workforce-imbalance correction decruiting 

rightsizing redundancy elimination 

indefinite idling career-change-opportunity creation 

downsizing permanent furloughing 

administrative streamlining personnel realignment 

synergy-related headcount restructuring 


ETHICS NOTE 


EUPHEMISMS AND TRUTH TELLING 

There is nothing wrong with using the euphemism restroom, even though few people visit 
one to rest. The British use the phrase go to the toilet in polite company, and nobody seems to 
mind. In this case, if you want to use a euphemism, no harm done. 

But it is unethical to use a euphemism to gloss over an issue that has important implications 
for people or the environment. People get uncomfortable when discussing layoffs — and they 
should. It's an uncomfortable issue. But calling a layoff a redundancy elimination initiative ought 
to make you even more uncomfortable. Don't use language to cloud reality. It's an ethical issue. 


BE CONCISE 

The following five principles can help you write concise technical documents: 

• Avoid obvious statements. 

• Avoid filler. 

• Avoid unnecessary prepositional phrases. 

• Avoid wordy phrases. 

• Avoid fancy words. 

Avoid Obvious Statements Writing can become sluggish if it overex- 
plains. The italicized words in the following example are sluggish: 

sluggish The market for the sale of flash memory chips is dominated by two 

chip manufacturers: Intel and Advanced Micro Systems. These two chip 
manufacturers are responsible for 76 percent of the $1 .3 billion market in 
flash memory chips last year. 
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improved The market for flash memory chips is dominated by Intel and Advanced 
Micro Systems, two companies that claimed 76 percent of the $1.3 billion 
industry last year. 

Avoid Filler In our writing, we sometimes use filler, much of which is more 
suited to speech. Consider the following examples: 

basically kind of 

certain rather 

essentially sort of 

Such words are common in oral communication, when we need to think fast, 
but they are meaningless in writing. 

bloated / think that, basically, the board felt sort of betrayed, in a sense, by the kind of 
behavior the president displayed. 

better The board felt betrayed by the president's behavior. 

But modifiers are not always meaningless. For instance, it might be wise to 
use I think or it seems to me to show that you are aware of other views. 

blunt Next year we will face unprecedented challenges to our market dominance. 

less blunt In my view, next year we will face unprecedented challenges to our market 
dominance. 

Of course, a sentence that sounds blunt to one reader can sound self- 
confident to another. As you write, keep your audience’s preferences and 
expectations in mind. 

Other fillers include redundant expressions, such as collaborate together, 
past history, end result, any and all, still remain, completely eliminate, and uery 
unique. Say it once. 

redundant This project would not have succeeded if not for the hard work and consider- 
able effort of each and every one of the auditors assigned to the project. 

better This project would not have succeeded if not for the hard work of every one 
of the auditors assigned to the project. 

Avoid Unnecessary Prepositional Phrases A prepositional phrase 
consists of a preposition followed by a noun or a noun equivalent, such as in 
the summary, on the engine, and under the heading. Unnecessary prepositional 
phrases, often used along with abstract nouns and nominalizations, can 
make your writing long and boring. 

long The increase in the number of students enrolled in the materials- 

engineering program at Lehigh University is suggestive of the regard in 
which that program is held fay the university's new students. 

shorter The increased enrollment in Lehigh University's materials-engineering 
program suggests that the university's new students consider it a good 
program. 
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Avoid Wordy Phrases Wordy phrases also make writing long and bor- 
ing. For example, some people write on a daily basis rather than daily. The 
long phrase may sound more important, but daily says the same thing more 
concisely. 

Table 10.1 lists common wordy phrases and their more concise equivalents. 


TABLE 10.1 Wordy Phrases and Their Concise Equivalents 


WORDY PHRASE 

CONCISE PHRASE 

WORDY PHRASE 

CONCISE PHRASE 

a majority of 

most 

in the event that 

if 

a number of 

some, many 

in view of the fact 
that 

because 

at an early date 

soon 

it is often the case 
that 

often 

at the conclusion of 

after, following 

it is our opinion that 

we thinkthat 

at the present time 

now 

it is our 

recommendation 

that 

we recommend that 

at this point in time 

now 

it is our 

understanding that 

we understand that 

based on the fact 
that 

because 

make reference to 

refer to 

check out 

check 

of the opinion that 

thinkthat 

despite the fact that 

although 

on a daily basis 

daily 

due to the fact that 

because 

on the grounds that 

because 

during the course of 

during 

prior to 

before 

during the time that 

during, while 

relative to 

regarding, about 

have the capability 

can 

so as to 

to 

to 




in connection with 

about, concerning 

subsequent to 

after 

in order to 

to 

take into 
consideration 

consider 

in regard to 

regarding, about 

until such time as 

until 
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Compare the following wordy sentence and its concise translation: 

wordy I am of the opinion that, in regard to profit achievement, the statistics 

pertaining to this month will appear to indicate an upward tendency. 

concise I think this month's statistics will show an increase in profits. 


Avoid Fancy Words Writers sometimes think they will impress their 
readers by using fancy words — utilize for use, initiate for begin, perform for do, 
due to for because, and prioritize for rank. In technical communication, plain 
talk is best. Compare the following fancy sentence with its plain-English ver- 
sion: 

fancy The purchase of a database program will enhance our record-maintenance 
capabilities. 

plain Buying a database program will help us maintain our records. 

Table 10.2 lists commonly used fancy words and their plain equivalents. 


TABLE 10.2 Fancy Words and Their Plain Equivalents 


FANCY WORD 

PLAIN WORD 

FANCY WORD 

PLAIN WORD 

advise 

tell 

herein 

here 

ascertain 

learn, find out 

impact (verb) 

affect 

attempt (verb) 

try 

initiate 

begin 

commence 

start, begin 

manifest (verb) 

show 

demonstrate 

show 

parameters 

variables, conditions 

due to 

because of 

perform 

do 

employ (verb) 

use 

prioritize 

rank 

endeavor (verb) 

try 

procure 

get, buy 

eventuate 

happen 

quantify 

measure 

evidence (verb) 

show 

terminate 

end, stop 

finalize 

end, settle, agree, 
finish 

utilize 

use 

furnish 

provide, give 
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DOCUMENT ANALYSIS ACTIVITY 


Revising for Conciseness and Simplicity 

The following passage is from a request for proposals published by the National Science Foundation. (Sentence numbers have been 
added here.) The questions below ask you to think about word choice (as discussed on pp. 236-39). 


1 . This passage contains many 
prepositional phrases. Iden- 
tify two of them. For each 
one, determine whether its 
use is justified or whether 
the sentence would be 
easier to understand if it 
were eliminated. 

2 . Part of this passage is writ- 
ten in the passive voice. 

Select one sentence in the 
passive voice that would be 
clearer in the active voice, 
and rewrite it in the active 
voice. 

3 . This passage contains a 
number of examples of 
fancy words. Identify two 
of them. Fiow can they be 
translated into plain 
English? 

Source: National Science Foundation, 2008: www.nsf.gov/pubs/policydocs/pappguide/nsf08_1/gpg_1 .jsp#IA1 . 


1 . Grants.gov, part of the President's Management Agenda to improve 
government services to the public, provides a single Government-wide portal 
for finding and applying for Federal grants online. 

2. Proposals submitted via Grants.gov must be prepared and submitted in 
accordance with the NSFGrants.gov Application Guide, available through Grants 
.gov as well as on the NSF website at: http://www.nsf.gov/bfa/dias/policy/ 
docs/grantsgovguide.pdf. 

3. The Grants.gov Application Guide contains important information on: 

• general instructions for submission via Grants.gov, including the Grants.gov 
registration process and Grants.gov software requirements; 

• NSF-specific instructions for submission via Grants.gov, including creation of 
PDF files; 

• grant application package instructions; 

• required SF 424 (R&R) forms and instructions; and 

• NSF-specific forms and instructions. 

4. Upon successful insertion of the Grants.gov submitted proposal in the NSF 
FastLane system, no further interaction with Grants.gov is required. 

5. All further interaction is conducted via the NSF FastLane system. 


USE INOFFENSIVE LANGUAGE 

Writing to avoid offense is not merely a matter of politeness; it is a matter 
of perception. Language reflects attitudes, but it also helps to form attitudes. 
Writing inoffensively is one way to break down stereotypes. 


For books about nonsexist writing, 
see the Selected Bibliography, 
p. 693. Many of the books in 
the Usage and General Writing, 
Handbooks for Grammar and Style, 
and Style Manuals sections address 
nonsexist writing. 


Nonsexist Language You can use your word processor to search for 
he, man, and men, the words and parts of words most often associated with 
sexist writing. Some grammar-checkers identify common sexist terms 
and suggest alternatives. But use what you know about the world. You 
don’t want to produce a sentence like this one from a benefits manual: 
“Every employee is responsible for the cost of his or her gynecological 
examination.” 
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Avoiding Sexist Language 


Follow these six suggestions for writing gender-neutral text. 

► Replace male-gender words with non-gender-specific words. Chairman, for 
instance, can become chairperson or chair. Firemen are firefighters; policemen are 
police officers. 

► Switch to a different form of the verb. 

sexist The operator must pass rigorous tests before he is 
promoted. 

nonsexist The operator must pass rigorous tests before being 
promoted. 

► Switch to the plural. 

nonsexist Operators must pass rigorous tests before they are promoted. 

Some organizations accept the use of plural pronouns with singular nouns, par- 
ticularly in memos and other informal documents: 

If an employee wishes to apply for tuition reimbursement, they should con- 
sult Section 14.5 of the Employee Manual. 

Careful writers and editors, however, resist this construction because it is gram- 
matically incorrect (it switches from singular to plural). In addition, switching to 
the plural can make a sentence unclear: 

unclear Operators are responsible for their operating manuals. 


► Switch to he or she, he/she, s/he, or his or her. He or she, his or her, and related 
constructions are awkward, especially if overused, but at least they are clear and 
inoffensive. 

► Address the reader directly. Use you and your or the understood you. 

[You] Enter the serial number in the first text box. 

► Alternate he and she. Language scholar Joseph Williams (2007) and many other 
language authorities recommend alternating he and she from one paragraph or 
section to the next. 


People-First Language for Referring to People with Disabilities 

Almost one in five Americans — some 56 million people — has a physical, 
sensory, emotional, or mental impairment that interferes with daily life 
(U.S. Census Bureau, 2012). In writing about people with disabilities, use the 
“people-first” approach: treat the person as someone with a disability, not as 
someone defined by that disability. The disability is a condition the person 
has, not what the person is. 


CLEAR 


Does each operator have one operating manual or more than 
one? 

Each operator is responsible for his or her operating manual. 
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Using the People-First Approach 


When writing about people with disabilities, follow these five guidelines, which are 

based on Snow (2009). 

► Refer to the person first, the disability second. Write people with mental retarda- 
tion, not the mentally retarded. 

► Don't confuse handicap with disability. Disability refers to the impairment or 
condition; handicap refers to the interaction between the person and his or her 
environment. A person can have a disability without being handicapped. 

► Don't refer to victimization. Write a person with AIDS, not an AIDS victim or an 
AIDS sufferer. 

► Don't refer to a person as wheelchair bound or confined to a wheelchair. People 
who use wheelchairs to get around are not confined. 

► Don't refer to people with disabilities as abnormal. They are atypical, not 


Because English is the language of more than half of the world’s scientific 
and technical communication, millions of nonnative speakers of English 
read technical documents in English. To address the information needs of 
such readers, many companies and professional associations have created 
versions of Simplified English. Each version consists of a basic set of gram- 
mar rules and a vocabulary of about 1,000 words, each of which has only one 
meaning: for example, right is the opposite of left; it does not mean “cor- 
rect.” Each version of Simplified English is made for a specific discipline. For 
example, ASD Simplified Technical English is intended for aerospace workers. 

Here is a sample of text and its Simplified English version. 

original version Before filling the gas tank, it is necessary to turn off 


abnormal. 


Understanding Simplified 
English for Nonnative Speakers 


SIMPLIFIED ENGLISH VERSION 


the propane line to the refrigerator. Failure to do so 
significantly increases the risk of explosion. 

Before you pump gasoline into the gas tank, turn off the 
propane line to the refrigerator. If you do not turn off the 
propane line, it could explode. 


For more on Simplified English, see ASD (2010). 


Preparing Text for Translation 


As discussed in Chapter 5, more and more organizations prepare their docu- 
ments and websites not only in English but also in other languages. Although 
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you won’t have to do the translating yourself, you should be aware of some 
simple steps you can take to make it easier for someone else to translate 
your writing. Luckily, most of the following seven steps are the same ones 
you use to make your writing clear and easy to read in English. 

• Use short sentences. Try for an average of no more than 20 words per 
sentence. 

• Use the active voice. The active voice (“You should do this procedure after 
the engine has run for 100 hours”) is easier to translate than the passive 
voice (“This procedure should be done after the engine has run for 100 
hours”). 

• Use simple words. Translators will find do easier to translate than perform. 

• Include a glossary. If you need to use technical terms, define them in a For more on glossaries, seeCh. 78, 

glossary. p.484. 

• Use words that have only one meaning. Write “This is the correct valve,” 
not “This is the right valve,” because right could also mean “the one on the 
right side.” 

• Use pronouns carefully. Don’t write “Matthews phoned Hawkins to ask if 
he was scheduled to speak at the meeting.” The translator might not know 
which person he refers to. Instead, write “Matthews phoned Hawkins to 
ask if Hawkins was scheduled to speak at the meeting.” 

• Avoid jokes, puns, and culture-bound references. Humor doesn’t translate 
well. If you refer to a box of computer pointing devices as “a box of mice,” 
the translator might translate the words literally because the device (a 
mouse) is not known by that name everywhere. Also avoid other culture- 
bound references, such as sports metaphors (hat trick or grand slam) or 
references to national heroes or holidays ( George Washington or Fourth of 
July). 


WRITER'S CHECKLIST 


Grammar 

Did you 

I avoid sentence fragments? (p. 21 7) 

I ] avoid comma splices? (p. 218) 

□ avoid run-on sentences? (p. 2 18) 

I avoid ambiguous pronoun references? (p. 2 19) 

□ compare items clearly? (p. 220) 

□ use adjectives clearly? (p.221) 

□ maintain subject-verb agreement? (p. 222) 


□ maintain pronoun-antecedent agreement? (p. 222) 

□ use tenses correctly? (p. 222) 

Sentences 

□ Are the sentences structured with the new or important 
information near the end? (p. 223) 

I Are the sentences of the appropriate length: neither 
long and difficult to understand nor short and choppy? 
(p. 224) 
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n Does each sentence focus on the "real" subject? (p. 225) 
I Have you limited the number of expletives used as 
sentence openers? (p. 226) 

I I Does each sentence focus on the "real" verb, without 

weak nominalizations? (p. 226) 

[ I Have you used parallel structure in your sentences? 

(p. 227) 

O Have you used restrictive and nonrestrictive modifiers 
appropriately? (p.228) 

n Have you eliminated misplaced modifiers, squinting 
modifiers, and dangling modifiers? (p. 229) 

Words and Phrases 

Did you 

LD select an appropriate level of formality? (p. 230) 

□ use active and passive voice appropriately? (p. 231) 

□ use precise words? (p. 233) 


□ provide adequate detail? (p. 233) 

I avoid ambiguity? (p. 233) 

LJ avoid unnecessary jargon? (p. 234) 

□ use positive rather than negative constructions? (p. 234) 

I avoid long noun strings? (p. 235) 

LJ avoid cliches? (p.235) 

□ avoid euphemisms? (p. 236) 

CH avoid stating the obvious? (p. 236) 

LJ avoid filler? (p. 237) 

□ avoid unnecessary prepositional phrases? (p. 237) 

□ use the most concise phrases? (p. 238) 

I ] avoid fancy words? (p. 239) 

□ use nonsexist language? (p. 240) 

□ use the people-first approach in referring to people with 
disabilities? (p. 241) 

I make your document easy to translate? (p. 242) 


EXERCISES 


NOTE: Pay close attention to what you are being asked 
to do in each exercise, and do only as much revising as 
is necessary. Take special care to preserve the meaning 
of the original material. If necessary, invent reasonable 
details. 

1 . Refer to the advice on pages 217-1 8, and rewrite 
each of the following sentences to eliminate sentence 
fragments. 

a. Nine bones from a Pacific walrus that were found in a 
coffin beneath St. Pancras Railway Station in London. 

b. The physical impossibility of knowing both the 
position and the momentum of a particle at the 
same time. 

2 . Refer to the advice on page 218, and rewrite each of the 
following sentences to eliminate comma splices. 

a. Porsche has won the J. D. Power new-model 
satisfaction award more than any other carmaker, the 
German company is expected to win next year, too. 

b. The federal Bureau of Safety and Environmental 
Enforcement is developing new regulations for 
offshore oil and gas operations in the Arctic, these 
regulations are expected to be ready for review later 
this year. 


3 . Refer to the advice on pages 218-1 9, and rewrite each 
of the following sentences to eliminate run-ons. 

a. A group of US scientists has encoded a 53,000-word 
book entirely in DNA this means DNA could become 
a future means of storing large amounts of data. 

b. Now you can burn your digital music library to DVDs 
burning to DVDs gives you a significant increase in 
storage space (4.7 Gb for a standard DVD v. 700 Mb 
for a CD). 

4 . Refer to the advice on pages 219-20, and rewrite each 
of the following sentences to eliminate ambiguous 
pronoun references. 

a. Kathleen Norris is in charge of analyzing the 
summer-semester orientation session, which is 
expected to last five days. 

b. The football program and the basketball programs 
are the highest grossing of the seventeen sports at 
the university. They posted revenues of $1.9 million 
last year. 

5 . Refer to the advice on pages 220-21, and rewrite each of 
the following sentences to eliminate unclear comparisons, 
a. The experiences of children with disabilities differ 

from adults with disabilities. 
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b. Universities enter into contracts with food-service 
providers more than hospitals. 

6. Refer to the advice on pages 221-22, and rewrite 
each of the following sentences to eliminate unclear 
adjectives. 

a. More Latinos in the United States than ever are 
watching news on English-language, television 
programs. 

b. There are four parking spots on campus that may be 
used only by Nobel Prize winning faculty. 

7 . Refer to the advice on page 222, and rewrite each of the 
following sentences so that it maintains subject-verb 
agreement. 

a. Samples from the survey is subject to sampling and 
nonsampling errors. 

b. The typical question received at our call centers are 
not answered in any of the user guides. 

8. Refer to the advice on page 222, and rewrite each of 
the following sentences so that it maintains pronoun- 
antecedent agreement. 

a. A researcher who has submitted all the IRB forms 
is still required to submit their proposal to the 
Research Committee. 

b. The team were assembled to carry out the study and 
report its findings to management. 

9 . Refer to the advice on pages 222-23, and rewrite each 
of the following sentences to eliminate incorrect use of 
tenses. 

a. Galileo paid dearly for his belief that the Earth 
revolved around the Sun. 

b. All the seminars finished by the time I arrived at 3:00 
on Thursday afternoon. 

10. The following sentences might be too long for some 
readers. Refer to the advice on page 234, and break 
each sentence into two or more sentences. 

a. If we get the contract, we must be ready by June 1 
with the necessary personnel and equipment, so 
with this in mind a staff meeting, which all group 
managers are expected to attend, is scheduled for 
February 12. 

b. Although we had a frank discussion with Backer's 
legal staff, we were unable to get them to specify 
what they would be looking for in an out-of-court 
settlement, but they gave us a strong impression 
that they would rather settle out of court. 


11. The following examples contain choppy, abrupt 
sentences. Refer to the advice on page 225, and 
combine sentences to create a smoother style. 

a. I need a figure on the surrender value of a policy. The 
number of the policy is A4399827. Can you get me 
this figure by tomorrow? 

b. The supervisor is responsible for processing the 
outgoing mail. Fie is also responsible for maintaining 
and operating the equipment. 

12. In the following sentences, the real subjects are buried 
in prepositional phrases or obscured by expletives. 

Refer to the advice on pages 225-26, and revise the 
sentences so that the real subjects appear prominently. 

a. There has been a decrease in the number of students 
enrolled in our training sessions. 

b. The use of in-store demonstrations has resulted in a 
dramatic increase in business. 

13. In the following sentences, unnecessary nominalization 
obscures the real verb. Refer to the advice on pages 
226-27, and revise the sentences to focus on the real 
verb. 

a. Pollution constitutes a threat to the Matthews 
Wildlife Preserve. 

b. Evaluation of the gumming tendency of the four 
tire types will be accomplished by comparing the 
amount of rubber that can be scraped from the tires. 

1 4. Refer to the advice on pages 227-28, and revise the 
following sentences to eliminate nonparallelism. 

a. The next two sections of the manual discuss howto 
analyze the data, the conclusions that can be drawn 
from your analysis, and how to decide what further 
steps are needed before establishing a journal list. 

b. In the box, we should include a copy of the 
documentation, the cables, and the docking station. 

1 5. Refer to the advice on pages 228-29, and revise the 
following sentences to correct punctuation or pronoun 
errors related to modifiers. 

a. This problem that has been traced to manufacturing 
delays, has resulted in our losing four major 
contracts. 

b. Please get in touch with Tom Flarvey who is updating 
the instructions. 

1 6. Refer to the advice on pages 229-30, and revise 
the following sentences to eliminate the misplaced 
modifiers. 
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a. Over the past three years we have estimated that 
eight hours per week are spent on this problem. 

b. Information provided by this program is displayed 
at the close of the business day on the information 
board. 

1 7. Refer to the advice on page 230, and revise the 
following sentences to eliminate the dangling 
modifiers. 

a. To examine the chemical homogeneity of the plaque 
sample, one plaque was cut into nine sections. 

b. The boats in production could be modified in 
time for the February debut by choosing this 
method. 

1 8. Refer to the advice on pages 230-3 1 , and revise the 
following informal sentences to make them moderately 
formal. 

a. The biggest problem faced by multimedia designers 
is that users freak if they don't see a button — or, 
heaven forbid, if they have to make up their own 
buttons! 

b. If the University of Arizona can't figure out where 
to dump its low-level radioactive waste, Uncle Sam 
could pull the plug on millions of dollars of research 
grants. 

1 9 . Refer to the advice on pages 23 1 -33, and rewrite the 
following sentences to remove inappropriate use of the 
passive voice. 

a. Mistakes were made. 

b. Come to the reception desk when you arrive. A 
packet with your name on it can be picked up there. 

20 . Refer to the advice on page 233, and revise the 
following sentences by replacing the vague elements 
with specific information. Make up any reasonable 
details. 

a. The chemical spill in the lab caused extensive 
damage. 

b. Analysis of the soil beneath the new stadium 
revealed an interesting fact. 

21 . Refer to the advice on page 234, and revise the 
following sentences to remove unnecessary jargon. 

a. We need to be prepared for blowback from the 
announcement. 

b. Police apprehended the perpetrator and placed her 
under arrest directly adjacent to the scene of the 
incident. 


22 . Refer to the advice on pages 234-35, and revise 
the following sentences to convert the negative 
constructions to positive constructions. 

a. Management accused Williams of filing trip reports 
that were not accurate. 

b. We must make sure that all our representatives do 
not act unprofessionally to potential clients. 

23 . General readers might find the following sentences 
awkward or difficult to understand. Refer to the advice 
on page 235, and rewrite the following sentences to 
eliminate the long noun strings. 

a. The research team discovered a glycerin-initiated, 
alkylene-oxide-based, long-chain polyether. 

b. We are considering purchasing a digital-imaging 
capable, diffusion-pump equipped, tungsten-gun SEM. 

24 . Refer to the advice on pages 235-36, and revise the 
following sentences to eliminate cliches. 

a. If we are to survive this difficult period, we are going 
to have to keep our ears to the ground and our 
noses to the grindstone. 

b. At the end of the day, if everyone is on the same 
page and it turns out to be the wrong page, you're 
really up a creek without a paddle. 

25 . Refer to the advice on page 236, and revise the 
following sentences to eliminate euphemisms. 

a. Downsizing our workforce will enable our division to 
achieve a more favorable cash-flow profile. 

b. Of course, accident statistics can be expected 
to show a moderate increase in response to a 
streamlining of the training schedule. 

26 . Refer to the advice on pages 236-37, and revise the 
following sentences to eliminate the obvious material. 

a. To register to take a course offered by the university, 
you must first determine whether the university will 
be offering that course that semester. 

b. The starting date of the project had to be postponed 
for a certain period of time due to a delay in 
obtaining the necessary authorization from the 
Project Oversight Committee. 

27 . Refer to the advice on page 237, and revise the 
following sentences to remove meaningless filler. 

a. For all intents and purposes, our company's long- 
term success depends to a certain degree on 
various factors that are in general difficult to 
foresee. 
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b. The presentation was generally well received for the 
most part, despite the fact that we received a rather 
small number of questionnaire responses. 

28. Refer to the advice on page 237, and revise the 
following sentences to remove the redundancies. 

a. In grateful appreciation of your patronage, we are 
pleased to offer you this free gift as a small token 
gesture of our gratitude. 

b. An anticipated major breakthrough in storage 
technology will allow us to proceed ahead in the 
continuing evolution of our products. 

29. Refer to the advice on page 237, and revise the 
following sentences to eliminate unnecessary 
prepositional phrases. 

a. The complexity of the module will hamper the ability 
of the operator in the diagnosis of problems in 
equipment configuration. 

b. The purpose of this test of your aptitudes is to help 
you with the question of the decision of which major 
to enroll in. 

30. Refer to the advice on pages 238-39, and revise the 
following sentences to make them more concise. 

a. The instruction manual for the new copier is lacking 
in clarity and completeness. 

b. We remain in communication with our sales staff on 
a weekly basis. 

31 . Refer to the advice on page 239, and revise the 
following sentences to eliminate fancy words. 

a. This state-of-the-art soda-dispensing module is to 
be utilized by Marketing Department personnel. 

b. We have failed to furnish the proposal to the proper 
agency by the mandated date by which such 
proposals must be in receipt. 


32. Refer to the advice on pages 240-41 , and revise the 
following sentences to eliminate sexist language. 

a. Each doctor is asked to make sure he follows the 
standard procedure for handling Medicare forms. 

b. Policemen are required to live in the city in which 
they work. 

33. Refer to the advice on pages 241 -42, and revise 
the following sentences to eliminate the offensive 
language. 

a. This year, the number of female lung-cancer victims 
is expected to rise because of increased smoking. 

b. Mentally retarded people are finding greater 
opportunities in the service sector of the economy. 

34. TEAM EXERCISE Form small teams. Flave one person 
on the team distribute a multipage document he or she 
has written recently, either in this class or in another. 
Have each member annotate a copy of the document 
according to the principles of sentence effectiveness 
discussed in this chapter. For advice on how to critique 
a draft effectively, see Ch. 4, p. 67. Then have each 
team member write a summary statement about the 
document, highlighting its effective techniques of 
sentence construction and possible improvements. 

Meet as a team, study these annotated documents, and 
write a memo to your instructor describing the sentence 
features cited by more than one team member, as well 
as those features cited by only one member. Overall, 
what are the basic differences between the team 
members'annotations and the summary statements? 

Do you think that, as a general practice, it would be 
worthwhile to have a draft reviewed and annotated by 
more than one person? What have you learned about 
the usefulness of peer review? 


For more practice with the concepts covered in this chapter, complete the 
LearningCurve activity "Writing Correct and Effective Sentences" under "Additional 
Resources" in Ch. 10: macmillanhighered.com/launchpad/techcomm11e. 


CASE 10: Revising a Document for Nonnative Speakers and forTranslation 



As an assistant in the U.S. Transportation Security Administration (TSA) Office of Traveller 
Information, you've been asked to revise a policy statement on airport screening into a 
consumer guide for travellers. Your department intends to translate the guide into a dozen 
languages, and your manager emphasizes that the writing must be as clear and as concise 
as possible. To access the policy statement and get to work, go to "Cases" under "Additional 
Resources" in Ch. 10 at macmillanhighered.com/launchpad/techcomm11e. 
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THE DESIGN OF a print or online document can help a writer achieve many 
goals: to entertain, to amaze, to intrigue, to sell. In technical communication, the 
goal is typically to help the reader learn something, perform a task, or accept a 
point of view. When you look at a well-designed page or screen, you intuitively 
understand how to use it. 
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DESIGNING PRINT AND ONLINE DOCUMENTS 


Design refers to the physical appearance of print and online documents. For 
print documents, design features include binding, page size, typography, and 
use of color. For online documents, many of the same design elements apply, but 
there are unique elements, too. On a web page, for instance, there are navigation 
bars, headers and footers, and (sometimes) tables of contents and site maps. 

The effectiveness of a document depends largely on how well it is designed, 
because readers see the document before they actually read it. In less than a 
second, the document makes an impression on them, one that might determine 
how well they read it — or even whether they decide to read it at all. 

Goals of Document Design 

In designing a document, you have five major goals: 

• To make a good impression on readers. Your document should reflect your 
own professional standards and those of your organization. 

• To help readers understand the structure and hierarchy of the information. 

As they navigate a document, readers should know where they are and 
how to get where they are headed. They should also be able to see the 
hierarchical relationship between one piece of information and another. 

• To help readers find the information they need. Usually, people don’t read 
every word in a print document, and they don’t study every screen of an 
online document. In print documents, design elements (such as tabs, 
icons, and color), page design, and typography help readers find the 
information they need quickly and easily. In online documents, design 
elements are critically important because readers can see only what is 
displayed on the screen; without design elements to help them navigate, 
they are stranded. 

• To help readers understand the information. Effective design can clarify 
information. For instance, designing a set of instructions so that the text 
describing each step is next to the accompanying graphic makes the 
instructions easier to understand. An online document with a navigation 
bar displaying the main sections is easier to understand than an online 
document without one. 

• To help readers remember the information. An effective design helps 
readers create a visual image of the information, making it easier to 
remember. Text boxes, pull quotes, and similar design elements help 
readers remember important explanations and passages. 


Understanding Design Principles 


Your biggest challenge in thinking about how to design a document is 
that, more than ever, readers control how the document appears. Although 
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you can still write a memo, print it on a piece of 8.5 x 11-inch paper, and 
stick it in an interoffice envelope, that model of print-only communication 
is becoming increasingly rare. Most of the time, readers encounter your 
document online. Even if you produced it with a word processor, designed it 
to fit on a piece of 8.5 x 11-inch paper, and saved it as a PDF to preserve the 
design, your readers can still zoom in or out, altering what appears on their 
screen. 

For documents that are intended to be viewed online, such as websites, 
apps, and other kinds of programs, readers can control many aspects of the 
design, including color and the size, shape, and location of objects on the 
screen. Perhaps the most significant variable that you have to consider is 
screen size. Some devices on which your readers will use your document 
will be as large as big-screen TVs, whereas others will be as small as wrist 
watches. 

In this chapter, the term print document will be used to refer to documents 
that are designed to be printed on paper, such as letters, memos, and reports, 
regardless of whether readers hold pieces of paper in their hands or view the 
documents online. The term online document will be used to refer to docu- 
ments that are designed to be used online, such as websites, apps, and other 
software programs. 

Because there are so many different types of print and online documents 
used in so many different environments by so many different people for so 
many different purposes, it is impossible to provide detailed advice about 
“how to design” a technical document. Still, there are some powerful and 
durable principles that can help you design any kind of print or online 
document. The following discussion is based on Robin Williams’s The Non- 
designer’s Design Book (2008), which describes four principles of design: 
proximity, alignment, repetition, and contrast. 

PROXIMITY 

The principle of proximity is simple: if two items appear close to each other, 
the reader will interpret them as related to each other. If they are far apart, 
the reader will interpret them as unrelated. Text describing a graphic should 
be positioned close to the graphic, as shown in Figure 11.1. 

ALIGNMENT 

The principle of alignment says that you should consciously line up text and 
graphics along a real or imaginary vertical axis so that the reader can under- 
stand the relationships among elements. Figure 11.2 on page 253 shows how 
alignment works to help organize information. 

REPETITION 

The principle of repetition says that you should format the same kind of 
information in the same way so that readers can recognize consistent pat- 



252 


11 


DESIGNING PRINT AND ONLINE DOCUMENTS 


Text and graphics are dearly related 
by the principle of proximity. The 
textual descriptions are placed next 
to the drawings to which they refer. 



FIGURE 11.1 Effective Use of Proximity 

Source: U.S. Department of State, 2011: http://future.state.gov. 


[1=1 To watch a tutorial on 

proofreading, go to Ch. 1 1 > 
Additional Resources > Tutorials: 

macmillanhighered.com 
/launchpad/techcomml 1e. 


terns. For example, all first-level headings should have the same typeface, 
type size, spacing above and below, and so forth. This repetition signals a 
connection between headings, making the content easier to understand. 
Other elements that are used to create consistent visual patterns are colors, 
icons, rules, and screens. Figure 11.3 shows an effective use of repetition. 

CONTRAST 

The principle of contrast says that the human eye is drawn to — and the brain 
interprets — differences in appearance between two items. For example, the 
principle of contrast explains why black print is easier to read against a white 
background than against a dark gray background; why 16-point type stands out 
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*V^Com^leting the SF424 (R&R) Application 

A. About the SF424 (R&R) Application Form 

1 . Which form should be used to submit electronic applications to NIH via Grahts.gov? 

This panel from an FAQ section of 
a website uses alignment to help 
organize the information. 

Applicants should use the Standard Form (SF) 424 Research 81 Related (R 81 R) family of forms. SF424 
consolidates grant applications, related data and forms currently used by Federal grant-making agencies 
to enable applicants to use familiar forms regardless of the program or agency to which they are applying. 
The SF424 Research 81 Related (R 8 Jt) will become the government- wide data set for research grant 
applications. The SF424 (R 8 Jt) will replace the Public Health Service (PHS) 398 form at NIH. 

The writer is using three levels of 
importance, each signaled by a 
different alignment. 

2 . Are SF424 components portable? Can components be reused for other applications? 


Currently there is no way to reuse the forms from one opportunity to another. Grants.gov hopes to have 
the functionality next year to import and export data for reuse with other applications. 


3. Where is the budget justification located? 


In the SF424 (R 8 tR) detailed budget component, the budget justification is item K--a PDF upload. In the 
PHS 398 Modular budget component, budget justifications for Personnel, Consortium and Additional 
Narrative are requested as separate PDF uploads as part of the Cumulative Budget Information. 


B. Application Instructions 

1. Where will an applicant need to look to find application instructions? 

Application instructions are available in two places: the SF424 (R&R) Application Guide and within each 
Funding Opportunity Announcement (FOA). The Application Guide includes all general instructions and a 

technique at a time to help organize 
information. In this case, text size 
and color also indicate levels of 
importance. 


FIGURE 1 1 .2 Effective Use of Alignment 

Source: National Institutes of Health, 2013a: http://grants.nih.gov/grants/ElectronicReceipt/faq_full 
.htm#application. 


Identify Key Terms 

Identify and explain the significance of each item below, 
open-field system (p. 289) Scholastics (p. 311) 

merchant guild (p. 299) vernacular literature (p. 314) 

craft guild (p. 300) troubadours (p. 315) 

Hanseatic League (p. 303) cathedral (p. 317) 

commercial revolution (p. 304) Romanesque (p. 317) 

sumptuary laws (p. 307) Gothic (p. 317) 

Review the Main Ideas 

Answer the focus questions from each section of the chapter. 

♦ What was village life like in medieval Europe? (p. 288) 

♦ How did religion shape everyday life In the High Middle Ages? (p. 293) 

• What led to Europe's economic growth and reurbanization? (p. 298) 

• What was life like in medieval cities? (p. 305) 

♦ How did universities serve the needs of medieval society? (p. 309) 

• How did literature and architecture express medieval values? (p. 313) 

9 Make Connections 

Think about the larger developments and continuities within and across chapters. 

1 . How was life in a medieval city different from life in a Hellenistic city (Chapter 4). or 
life in Rome during the time of Augustus (Chapter 6 )? In what ways was it similar? 
What problems did these cities confront that are still Issues for cities today? 

2 . Historians have begun to turn their attention to the history of children and childhood. How 
were children's lives in the societies you have examined shaped by larger social structures 
and cultural forces? What commonalities do you see in children’s lives across time? 

3 . Chapter 4 and this chapter both examine ways in which religion and philosophy shaped 
life for ordinary people and for the educated elite. How would you compare Hellenistic 
religious practices with those of medieval Europe? How would you compare the ideas 
of Hellenistic philosophers such as Epicurus or Zeno with those of Scholastic philoso- 
phers such as Thomas Aquinas? 


This page shows repetition used 
effectively as a design element. 
Different colors, typefaces, and type 
sizes are used for the headings, 
instructions, and text. 

The two lists make use of stylized 
bullets and oversize numbers, both 
in one of the two main colors. 


FIGURE 1 1 .3 Effective Use of Repetition 

Source: Excerpt from A HISTORY OF WESTERN SOCIETY, Eleventh Edition (Boston: Bedford/St. Martin's, 
2014). John P. McKay, Clare Haru Crowston, Merry E. Wiesner-Hanks, Joe Perry, p. 319. 
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Notice that you do not have to use 
a strikingly different color to show 
contrast. The human brain can eas- 
ily tell the difference between the 
pale blue and the navy blue of the 
other boxes. 



FIGURE 11.4 Effective Use of Contrast 

This portion of a web page shows effective use of color contrast in the five navigation boxes. The pale 
blue screen behind the word “Impact" helps visitors see which portion of the site they are viewing. 
Source: U.S. Department of State, 2013b: http://eca.state.gov/impact. 


more clearly against 8-point type than against 12-point type; and why informa- 
tion printed in a color, such as red, grabs readers’ attention when the informa- 
tion around it is printed in black. Figure 11.4 shows effective use of contrast. 


Planning the Design of Print 
and Online Documents 

In a typical day at work, you might produce a number of documents without 
having to worry about design at all. Blog posts, text messages, presentation 
slides and memos that use standard company templates — these applications 
and others present no design challenges either because you cannot design 
them or because you don’t have the authority to design them. 

You will, however, have a say in the design of many documents you pro- 
duce or to which you contribute. In a case like this, the first step in design- 
ing the document is to plan. Analyze your audience and purpose, and then 
determine your resources. 


For more about analyzing your 
audience, see Ch. 5. For more about 
tables of contents, see Ch. 18, p. 480. 


ANALYZE YOUR AUDIENCE AND PURPOSE 

Consider factors such as your readers’ knowledge of the subject, their atti- 
tudes, their reasons for reading, the way they will be using the document, 
and the kinds of tasks they will perform. For instance, if you are writing a 
benefits manual for employees, you know that few people will read it from 
start to finish but that many people will refer to it. Therefore, you should 
include accessing tools: a table of contents, an index, tabs, and so forth. 

Think too about your audience’s expectations. Readers expect to see 
certain kinds of information presented in certain ways. Try to fulfill those 
expectations. For example, hyperlinks on websites are often underscored and 
presented in blue type. 

If you are writing for multicultural readers, keep in mind that many 
aspects of design vary from one culture to another. In memos, letters, reports, 
and manuals, you may see significant differences in design practice. The best 
advice, therefore, is to study documents from the culture you are addressing. 
Here are a few design elements to look for: 
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• Paper size. Paper size will dictate some aspects of your page design. If 
your document will be printed in another country, find out about standard 
paper sizes in that country. 

• Typeface preferences. One survey found that readers in the Pacific Rim 
prefer sans-serif typefaces in body text, whereas Western readers prefer 
serif typefaces (Ichimura, 2001). 

• Color preferences. In China, for example, red suggests happiness, whereas 
in Japan it suggests danger. 

• Text direction. If some members of your audience read from right to left but 
others read from left to right, you might arrange your graphics vertically, from 
top to bottom; everybody reads from top to bottom. Or you might use Arabic 
numerals to indicate the order in which items are to be read (Horton, 1993). 
Think, too, about your purpose or purposes. For example, imagine that 

you are opening a dental office and you want to create a website. The first 
question is What is the purpose of the site? It’s one thing to provide informa- 
tion on your hours and directions to the office. But do you also want to direct 
patients to high-quality dental information? To enable them to set up or 
change appointments? Ask you a question? Each of these purposes affects 
the design, whether the document is going to print or online. 

DETERMINE YOUR RESOURCES 

Think about your resources of time, money, and equipment. Short, informal 
documents are usually produced in-house; more-ambitious projects are often 
subcontracted to specialists. If your organization has a technical-publications 
department, consult the people there about scheduling and budgeting. 

• Time. What is your schedule? To come up with a sophisticated design you 
might need professionals at service bureaus or print shops or specialists 
in online production. These professionals can require weeks or months. 

• Money. Can you afford professional designers, print shops, and online- 
content developers? Most managers would budget thousands of dollars to 
design an annual report but not an in-house newsletter. 

• Equipment. Complex designs require graphics and web software, as well as 
layout programs. A basic laser printer can produce attractive documents 
in black and white, but you need a more expensive printer for high- 
resolution color. 


Designing Print Documents 

Before you design the individual pages of a printed document, design the 
overall document. Decide whether you are creating a document that looks 
like a book, with content on both sides of the page, or a document that looks 
like a report, with content on only one side of the page. Decide whether to 
use paper of standard size (8.5 x 11 inches) or another size, choose a grade 
of paper, and decide how you will bind the pages together. Decide about 


Typography is discussed on 
pp. 265-71. 


For more about analyzing your 
purpose, see Ch. 5, p. 84. 


For information on designing online 
documents, see pp. 281 and 287. 
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the accessing elements you will include, such as a table of contents, index, 
and tabs. You want the different elements to work together to accomplish 
your objectives, and you want to stay within your budget for producing and 
(perhaps) shipping. That is, in designing the whole document, consider these 
four elements: size, paper, bindings, and accessing aids. 

SIZE 

Size refers to two aspects of print-document design: page size and page 
count. 

• Page size. Think about the best page size for your information and about 
how the document will be used. For a procedures manual that will sit on 
a shelf most of the time, three-hole 8.5 x 11-inch paper is a good choice. 
For a software tutorial that must fit easily on a desk while the reader 
works at the keyboard, consider a 5.5 x 8.5-inch size. Paper comes 
precut in a number of sizes, including 4.5 x 6 inches and 6x9 inches. 
Although paper can be cut to any size, nonstandard sizes are more 
expensive. 

• Page count. Because paper is expensive and heavy, you want as few 
pages as possible, especially if you are printing and mailing many copies. 
And there is a psychological factor, too: people don’t want to spend a 

lot of time reading technical documents. Therefore, if you can design a 
document so that it is 15 pages long rather than 30 — but still attractive 
and easy to read — your readers will appreciate it. 

PAPER 

Paper is made not only in different standard sizes but also in different 
weights and with different coatings. Heavier paper costs more than lighter 
paper but provides better resolution for text and graphics. Coated paper is 
stronger and more durable than non-coated paper and provides the best 
resolution, but some coatings can produce a glare. To deal with this problem, 
designers often choose paper with a slight tint. 

Work closely with printing professionals. They know, for example, about 
UV-coated paper, which greatly reduces fading, and about recycled paper, 
which is continually improving in quality and decreasing in price. 

BINDINGS 

Although the pages of a very short document can be attached with a paper 
clip or a staple, longer documents require more-sophisticated binding tech- 
niques. Table 11.1 illustrates and describes the four types of bindings com- 
monly used in technical communication. 

ACCESSING AIDS 

In a well-designed document, readers can easily find the information they 
seek. Most accessing aids use the design principles of repetition and contrast 
to help readers navigate the document. Table 11.2 on page 258 explains six 
common kinds of accessing aids. 
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>TECH TIP 


HowTo Set Up Pages 


When designing a page to 
meet your audience's needs 
and expectations, you can 
control many design ele- 
ments by using the Page 
Setup dialog box or the 
drop-down menus in the / 
Page Setup group on the / 
Page Layout tab. / 

In the Page Setup group, 
use the Page Setup dialog 
box launcher to display the 
Page Setup dialog box. 



Use the Margins, Paper, and Layout tabs to specify such de- 
sign elements as page margins, paper orientation, paper size, 
starting locations for new sections, and header and footer 
placement. 


You can also use the drop-down menus on the Page Setup 
group to control many of the same design elements. 



Inwl || PtpeUywt } 

N Orientation * £={ Bread - 
| j Site * line numbers * 

II Column; - be" Hiflhenation * 
Pape Setup oj 


KEYWORDS: page layout tab, page setup group, page setup, 
margins, paper, layout 


TABLE 11.1 Common Types of Binding 



Loose-leaf binders. Loose-leaf binders are convenient 
when pages must be added and removed frequently. A 
high-quality binder can cost as much as several dollars. 


Image Credit: © 2014 Macmillan. 
Photo by Regina Tavani. 



Image Credit: © 2014 Macmillan. 
Photo by Regina Tavani. 


Ring or spiral binders. The wire or plastic coils or combs 
that hold the pages together enable you to open the 
document flat on a desk or even fold it over so that it 
takes up the space of only one page. Print shops can 
bind documents of almost any size in plastic coils or 
combs for about a dollar each. 


Saddle binding. The document is opened to its middle 
pages, and large staples are inserted from the outside. 
Saddle binding is impractical for large documents. 


Image Credit: © 2014 Macmillan. 
Photo by Regina Tavani. 



Image Credit: © 2014 Macmillan. 
Photo by Regina Tavani. 


Perfect binding. Pages are glued together along the 
spine edge, and a cover is attached. Perfect binding, 
used in book publishing, produces the most formal 
appearance, but it is relatively fragile, and the open 
document usually does not lie flat. 
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TABLE 1 1 .2 Typical Accessing Aids 


For more about using color, see 
Ch. 12, p. 303. 


Media 


a 

YouTube 

Watch, upload and share videos 

BJ 

Books 

Search the full text of books 



News 

if 

Search thousands of news stones 

© 

Picasa 

Fold, edit and share your photos 


Source: Google, 2013: http://www 
.google.com/intl/en/about/products. 



Here green is used to emphasize the titles of the 
sections, the box at the top left, and the bar along the 
edge of the page. 

Source: Excerpt from MEDIA & CULTURE: MASS COMMUNI- 
CATION IN A DIGITAL AGE, Ninth Edition (Boston: Bedford/ 
St. Martin's, 2014). Richard Campbell, Christopher R. Martin, 
Bettina Fabos, p. 1 13. 



Image Credit: © 2014 Macmillan. Photo by Regina Tavani. 


Icons. Icons are pictures that symbolize 
actions or ideas. Perhaps the most 
important icon is the stop sign, which 
alerts you to a warning. Icons depend 
on repetition: every time you see the 
warning icon, you know what kind of 
information the writer is presenting. 

Don't be too clever in thinking up 
icons. One computer manual uses 
a cocktail glass about to fall over to 
symbolize "tip."This is a bad idea, 
because the pun is not functional: 
when you think of a cocktail glass, 
you don't think of a tip for using 
computers. Don't use too many 
different icons, or your readers will 
forget what each one represents. 

Color. Perhaps the strongest visual 
attribute is color (Keyes, 1993). Use 
color to draw attention to important 
features of the document, such as 
warnings, hints, major headings, and 
section tabs. But use it sparingly, or it 
will overpower everything else in the 
document. 

Color exploits the principles of 
repetition (every item in a particular 
color is logically linked) and contrast 
(items in one color contrast with items 
in another color). 

Use color logically. Third-level 
headings should not be in color, for 
example, if first- and second-level 
headings are printed in black. 

Using paper of a different color for 
each section of a document is another 
way to simplify access. 

Dividers and tabs. You are already 
familiar with dividers and tabs from 
loose-leaf notebooks. A tab provides 
a place for a label, which enables 
readers to identify and flip to a 
particular section. Sometimes dividers 
and tabs are color-coded. Tabs work 
according to the design principle of 
contrast: the tabs literally stick out. 


( continued ) 
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TABLE 1 1 .2 Typical Accessing Aids ( continued ) 


Read... To learn to... Cross-reference tables. These tables, 

Ch. 1 connect to the router which exploit the principle of alignment, 

Ch.2 set up a firewall refer readers to related discussions. 



Source: General Services Administration, 2013. 


Headers and footers. Headers and 
footers help readers see where they are 
in the document. In a book, for example, 
the headers on the left-hand pages 
might repeat the chapter number and 
title; those on the right-hand pages 
might contain the most recent first-level 
heading. Sometimes writers build other 
identifying information into the headers. 
For example, your instructor might ask 
you to identify your assignments with 
a header like the following:"Smith, 
Progress Report, English 302, page 6." 
Headers and footers work according to 
the principle of repetition: readers learn 
where to look on the page to see where 
they are in the document. 



Source: Excerpt from THE BEDFORD GUIDE FOR COLLEGE WRIT- 
ERS, Tenth Edition {Boston: Bedford/St. Martin's, 2014). 

X. J. Kennedy, Dorothy M. Kennedy, and Marcia F. Murth, 
pp. xxxi, 703, A-21. 


Page numbering. For one-sided 
documents, use Arabic numerals in 
the upper right corner, although the 
first page of most documents does not 
have a number on it. For two-sided 
documents, put the page numbers 
near the outside margins. 

Complex documents often use two 
number sequences: lowercase Roman 
numerals (i, ii, and so on) for front 
matter and Arabic numerals for the 
body. There is no number on the title 
page, but the page following it is ii. 

Appendixes are often paginated with 
a letter and number combination: 
Appendix A begins with page A-1, 
followed by A-2, and so on; Appendix 
B starts with page B-1 . 

Sometimes documents list the total 
number of pages in the document (so 
recipients can be sure they have all 
of them). The second page is "2 of 1 7," 
and the third page is "3 of 1 7." 

Documents that will be updated are 
sometimes numbered by section: 
Section 3 begins with page 3-1, 
followed by 3-2; Section 4 begins with 
4-1 .This way, a complete revision of 
one section does not affect the page 
numbering of subsequent sections. 
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Designing Print Pages 

In a well-designed printed page of technical communication, the reader can 
recognize patterns, such as where to look for certain kinds of information. 




GUIDELINES 


Understanding Learning Theory and Page Design 


In designing the page, create visual patterns that help readers find, understand, and remember information. Three prin- 
ciples of learning theory, the result of research into how people learn, can help you design effective pages: chunking, 
queuing, and filtering. 


► Chunking. People understand information best if it is delivered to them in chunks — small units — rather than all at once. 
For single-spaced type, chunking involves double-spacing between paragraphs, as shown in Figure 1 1 .5. 


During the 18th century, there were many wars in Europe caused by the 
ambition of various kings to make their domains larger and to increase their own 
incomes. King Louis XIV of France had built up a very powerful kingdom. Brave 
soldiers and skillful generals spread his rule over a great part of what is Belgium 
and Luxemburg, and annexed to the French kingdom the part of Germany be- 
tween the Rhine River and the Vosges (Vo_zh) Mountains. 

Finally, the English joined with the troops of the Holy Roman Empire to curb 
the further growth of the French kingdom, and at the battle of Blenheim (1704), 
the English Duke of Marlborough, aided by the emperor's army, put an end to the 
further expansion of the French. 

The 18th century also saw the rise of a new kingdom in Europe. You will 
recall that there was a county in Germany named Brandenburg, whose count was 
one of the seven electors who chose the emperor. The capital of this county was 
Berlin. It so happened that a number of Counts of Brandenburg, of the family of 
Hohenzollem, had been men of ambition and ability. The little county had grown 
by adding small territories around it. One of these counts, called "the Great Elec- 
tor," had added to Brandenburg the greater part of the neighboring county of 
Pomerania. His son did not have the ability of his father, but was a very proud 

He happened to visit King William III of England, and was very much of- 
fended because during the interview, the king occupied a comfortable arm chair, 
while the elector, being simply a count, was given a chair to sit in which was 
straight-backed and had no arms. Brooding over this insult, as it seemed to him, he 
went home and decided that he too should be called a king. The question was, what 
should his title be. He could not call himself "King of Brandenburg," for Branden- 
burg was part of the Empire, and the emperor would not allow it. It had happened 
some one hundred years before, that, through his marriage with the daughter of the 
Duke of Prussia, a Count of Brandenburg had come into possession of the district 
known as East Prussia, at the extreme southeastern comer of the Baltic Sea. 

The son of this elector who first called himself king had more energy and 
more character than his father. He ruled his country with a rod of iron, and built up 
a strong, well-drilled army. He was especially fond of tall soldiers, and had agents 
out all over Europe, kidnapping men who were over six feet tall to serve in his fa- 
mous regiment of Guards. He further increased the size of the Prussian kingdom. 

His son was the famous Frederick the Great, one of the most remarkable 
fighters that the world has ever seen. This prince had been brought up under 
strict discipline by his father. The old king had been insistent that his son should 
be no weakling. It is told that one day, finding Frederick playing upon a flute, he 
seized the instrument and snapped it in twain over his son's shoulder. 


France in the 18th Century 

During the 18th century, there were many wars in Europe caused by the ambi- 
tion of various kings to make their domains larger and to increase their own 
incomes. King Louis XIV of France had built up a very powerful kingdom. Brave 
soldiers and skillful generals spread his rule over a great part of what is Belgium 
and Luxemburg, and annexed to the French kingdom the part of Germany be- 
tween the Rhine River and the Vosges (Vo_zh) Mountains. 

Finally, the English joined with the troops of the Holy Roman Empire to curb the 
further growth of the French kingdom, and at the battle of Blenheim (1704), the Eng- 
lish Duke of Marlborough, aided by the emperor's army, put an end to the further 
expansion of the French. 

Prussia in the 18th Century 

The 18th century also saw the rise of a new kingdom in Europe. You will recall 
that there was a county in Germany named Brandenburg, whose count was 
one of the seven electors who chose the emperor. The capital of this county was 
Berlin. It so happened that a number of Counts of Brandenburg, of the family 
of Hohenzollern, had been men of ambition and ability. The little county had 
grown by adding small territories around it. One of these counts, called "the 
Great Elector," had added to Brandenburg the greater part of the neighboring 
county of Pomerania. His son did not have the ability of his father, but was a 
very proud and vain man. 

He happened to visit King William in of England, and was very much offended 
because during the interview, the king occupied a comfortable arm chair, while 
the elector, being simply a count, was given a chair to sit in which was straight- 
backed and had no arms. Brooding over this insult, as it seemed to him, he 
went home and decided that he too should be called a king. The question was, 
what should his title be. He could not call himself "King of Brandenburg," for 
Brandenburg was part of the Empire, and the emperor would not allow it. It had 
happened some one hundred years before, that, through his marriage with the 
daughter of the Duke of Prussia, a Count of Brandenburg had come into posses- 
sion of the district known as East Prussia, at the extreme southeastern corner of 
the Baltic Sea. 

The son of this elector who first called himself king had more energy and more 
character than his father. He ruled his country with a rod of iron, and built up 
a strong, well-drilled army. He was especially fond of tall soldiers, and had 
agents out all over Europe, kidnapping men who were over six feet tall to serve 
in his famous regiment of Guards. He further increased the size of the Prussian 


a. Without chunking b. With chunking 

FIGURE 11.5 Chunking 

Chunking emphasizes units of related information. Note how the use of headings creates clear chunks of information. 


( continued ) 
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► Queuing. Queuing refers to creating visual distinctions to indicate levels of importance. More-emphatic 
elements — those with bigger type or boldface type — are more important than less-emphatic ones. Another 
visual element of queuing is alignment. Designers start more-important information closer to the left margin and 
indent less-important information. (An exception is titles, which are often centered in reports in the United States.) 
Figure 1 1 .6 shows queuing. 

► Filtering. Filtering is the use of visual patterns to distinguish various types of information. Introductory material 
might be displayed in larger type, and notes might appear in italics, another typeface, and a smaller size. Figure 1 1 .7 
shows filtering. 



FIGURE 11.6 Queuing 

Source: U.S. Department of State, 2013a: www.state.gov/documents 
/organization/203937. pdf. 


NOAA's National Weather Service 
Heat Index 
Temperature (°F) 


Strategic Goals and Results 


The size of the type used for the various headings 
indicates their importance. 

The largest type suggests that "Strategic Goals and 
Results" is a chapter heading. 

The next largest type indicates that "Strategic Goal 
1: Achieving Peace and Security" is an A head (the 
highest level within a chapter). 

"Public Benefit" and "Summary of Performance and 
Resources" are B heads. 


Likelihood of Heat Disorders with Prolonged Exposure or Strenuous Activity 

□ Caution QJ Extreme Caution ■ Danger ■ Extreme Danger 


FIGURE 11.7 Filtering 

Effective technical communication presents data and explains what 
the data mean. In this table about the heat index, the writer uses 
color as a filtering device. In Western cultures, red signals danger. 
Source: National Weather Service, 2014: http://nws.noaa.gov/os/heat/index.shtml. 
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PAGE LAYOUT 

Every page has two kinds of space: white space and space devoted to text 
and graphics. The best way to design a page is to make a grid: a drawing of 
what the page will look like. In making a grid, you decide how to use white 
space and determine how many columns to have on the page. 

Page Grids As the phrase suggests, a page grid is like a map on which you 
plan where the text, the graphics, and the white space will go. Many writers 
like to begin with a thumbnail sketch, a rough drawing that shows how the text 
and graphics will look on the page. Figure 11.8 shows thumbnail sketches of 
several options for a page from the body of a manual. 

Experiment by sketching the different kinds of pages of your document: 
body pages, front matter, and so on. When you are satisfied, make page grids. 
You can use either a computer or a pencil and paper, or you can combine the 
two techniques. 

Figure 11.9 shows two simple grids: one using picas (the unit that printing 
professionals use, which equals one-sixth of an inch) and one using inches. 
On the right is an example of a page laid out using the grid in the figure. 



FIGURE 11.8 Thumbnail Sketches 






FIGURE 1 1 .9 Sample Grids Using Picas and Inches 

Source: Excerpt from LISTEN, Brief Fifth Edition (Boston: Bedford/St. Martin's, 2004). J. Kerman and G. Tomlinson, p. 388. 
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a. Double-column grid 
Excerpt from Gardner and Barefoot, YOUR COLLEGE 
EXPERIENCE: STUDY SKILLS EDITION, 1 0th ed., p. 31 . 
Copyright © 201 3 Bedford/St. Martin's. Reprinted 
by permission. 



b. Two-page grid, with narrow outside columns for notes 

Excerpt from Kennedy, Kennedy, and Muth, THE BEDFORD GUIDE FOR COLLEGE WRITERS WITH READER, 
Tenth Edition, pp. 130-131. Copyright © 2014 Bedford/St. Martin's. Reprinted by permission. 



c. Three-panel brochure 

Source: Centers for Disease Control and Prevention, 2014: http://www.cdc.gov/healthywater/pdf/swimming/resources/healthy-swimming-rwi-brochure.pdf. 


FIGURE 11.10 Popular Grids 


Create different grids until the design is attractive, meets the needs of 
your readers, and seems appropriate for the information you are conveying. 
Figure 11.10 shows some possibilities. 

White Space Sometimes called negative space, white space is the area of 
the paper with no writing or graphics: the space between two columns of 
text, the space between text and graphics, and, most obviously, the margins. 
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M 8 V 2 " ► 

A 


Increase the size of the margins 
if the subject is difficult or if your 
readers are not knowledgeable 
about it. 


V 


FIGURE 11.11 Typical Margins fora Document That Is Bound 
Like a Book 



Left-hand page Right-hand page 


For more about marginal glosses, 
seep. 274. 


Margins, which make up close to half the area on a typical page, serve four 
main purposes: 

• They reduce the amount of information on the page, making the 
document easier to read and use. 

• They provide space for binding and allow readers to hold the page without 
covering up the text. 

• They provide a neat frame around the type. 

• They provide space for marginal glosses. 

Figure 11.11 shows common margin widths for an 8.5 x 11-inch document. 

White space can also set off and emphasize an element on the page. For 
instance, white space around a graphic separates it from the text and draws 
readers’ eyes to it. White space between columns helps readers read the text 
easily. And white space between sections of text helps readers see that one 
section is ending and another is beginning. 

COLUMNS 

Many workplace documents have multiple columns. A multicolumn design 
offers three major advantages: 

• Text is easier to read because the lines are shorter. 

• Columns allow you to fit more information on the page, because many 
graphics can fit in one column or extend across two or more columns. In 
addition, a multicolumn design enables you to put more words on a page 
than a single-column design. 
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HowTo Format Columns 


A multicolumn design allows you to fit more text on a page, 
create easier-to-read pages, and use more options when 
sizing graphics. To divide your 
document into multiple col- 
umns, select the Page 
Layout tab to use the 
Columns drop-down menu in 
the Page Setup group. 


In the Page Setup group, 
select Columns. 

You can use preset layouts. - 


Page Layout 


□ _fo Orientation * *S| Breaks * 

15 Sl« * Line Numbers * 

Margins - — 77—3 

Columns * j be' Hyphenation • 


J 


You can also select More Col- 
umns to launch the Columns 
dialog box. You can control 
the number of columns and 
specify the width and spacing yourself. 


II More Columns... 


umns.-bi 



When you divide your document into columns, text flows 
from the bottom of one column to the top of the next col- 
umn. Columns enable you to use the principle of repetition 
to create a visual pattern, such as text in one column and 
accompanying graphics in an adjacent column. 


If you want to end a column of text in a specific location or 
create columns of equal length, use the Breaks drop-down 
menu to insert a column break. This action will move the text 
following the break to the next column. 




KEYWORDS: columns, breaks, column break, page setup 
group 


• Columns enable you to use the principle of repetition to create a visual 
pattern, such as text in one column and accompanying graphics in an 
adjacent column. 

TYPOGRAPHY 

Typography, the study of type and the way people read it, encompasses 
typefaces, type families, case, and type size, as well as factors that affect the 
white space of a document: line length, line spacing, and justification. 

Typefaces A typeface is a set of letters, numbers, punctuation marks, and 
other symbols, all bearing a characteristic design. There are thousands of 
typefaces, and more are designed every year. Figure 11.12 on page 266 shows 
three contrasting typefaces. 
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FIGURE 11.12 Three 
Contrasting Typefaces 


As Figure 11.13 illustrates, typefaces are generally classified into two cat- 
egories: seri/and sans serif. 


Although scholars used to think that serif typefaces 
were easier to read because the serifs encourage 
readers' eyes to move along the line, most now 
believe that there is no difference in readability 
between serif and sans-serif typefaces, either in 
print or online. Readers are most comfortable with 
the style they see most often. 


Most of the time you will use a handful of standard typefaces such as 
Times New Roman, Cambria, Calibri, and Arial, which are included in your 
word-processing software and which your printer can reproduce. 

Type Families Each typeface belongs to a family of typefaces, which con- 
sists of variations on the basic style, such as italic and boldface. Figure 11.14, 
for example, shows the Helvetica family. 


Helvetica Light 

Helvetica Bold Italic 

Helvetica Light Italic 

Helvetica Heavy 

Helvetica Regular 

Helvetica Heavy Italic 

Helvetica Regular Italic 

Helvetica Regular Condensed 

Helvetica Bold 

Helvetica Regular Condensed Italic 



FIGURE 11.13 Serif and 
Sans-Serif Typefaces 


cTfua paroupapll in tupcr) in eft encfi Script tvjpcjace. "Ijair atv un£iicc Htf to ace tfua attjlc <f font in a tecfrmcaf 
Hoc umenJC Hecaano it in too at note anil too Ho/wl to ^caZ. St in fiettet awitcfl to We33in<^ in^itationn anil otfiee 
jocinot announeementa. 

This paragraph is Times Roman. It looks like the kind of type used by the New York Times and 
other newspapers in the nineteenth century. It is an effective typeface for text in the body of 
technical documents. 

This paragraph is Univers, which has a modern, high-tech look. It is best suited for 
headings and titles in technical documents. 


FIGURE 1 1.14 Helvetica Family of Type 
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>TECH TIP 


HowTo Format Fonts 


To improve the readability of your document, you can use 
the Font group on the Home tab to specify typographical 
elements such as typeface, style, size, color, character spacing, 
and text effects. 


In the Font group menu, 
use the Font dialog box 
launcher to display the Font 
dialog box. 


You can change the appear- 
ance of a typeface by check- 
ing Effects boxes. 



You can also specify basic font formatting such as typeface, 
type size, bold, italic, and underlining by using drop-down 
menus and buttons in the Font group. 


[TimesNewRom ’';12 - A* A* Aa" | ^ 

Font r» 


KEYWORDS: font group, font, font style 


Be careful not to overload your document with too many different mem- 
bers of the same family. Used sparingly and consistently, these variations 
can help you with filtering: calling attention to various kinds of text, such as 
warnings and notes. Use italics for book titles and other elements, and use 
bold type for emphasis and headings. Stay away from outlined and shadowed 
variations. You can live a full, rewarding life without ever using them. 

Case To make your document easy to read, use uppercase and lowercase 
letters as you would in any other kind of writing (see Figure 11.15). Most 
people require 10 to 25 percent more time to read text using all uppercase 
letters than to read text using both uppercase and lowercase. In addition, 
uppercase letters take up as much as 35 percent more space than lowercase 
letters (Haley, 1991). If the text includes both cases, readers will find it easier 
to see where new sentences begin (Poulton, 1968). 


In dividu al variations are greater in lowercase wo rds 
THAN THEY ARE IN UPPERCASE WORDS. 


FIGURE 11.15 Individual Variations in Lowercase and Uppercase Type 

Lowercase letters are easier to read than uppercase because the individual variations from one letter to 
another are greater. 
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1 — q 

72 — ^ 

6 — — 


60— B 

5 — 


48— B 

4 


36 — M 

3 — 


24— H 

2 


12— B 

1 — 

o — 1 

0— ■ 

0 — 

inches points 

picas 


Type Size Type size is measured with a unit called a point. There are 12 
points in a pica and 72 points in an inch. In most technical documents 10-, 
11-, or 12-point type is used for the body of the text: 

This paragraph is printed in 10-point type. This size is easy to 
read, provided it is reproduced on a high-quality ink-jet printer or 
laser printer. 

This paragraph is printed in 12-point type. If the docu- 
ment will be read by people over age 40, 12-point type 
is a good size because it is more legible than a smaller 
size. 


This paragraph is printed in 14-point type. This 
size is appropriate for titles or headings. 

Type sizes used for other parts of a document include the following: 
footnotes 8- or 9-point type 

indexes 2 points smaller than body text 

slides or transparencies 24- to 36-point type 

In general, aim for at least a 2- to 4-point difference between the headings 
and the body. Too many size variations, however, suggest a sweepstakes 
advertisement rather than a serious text. 


ETHICS NOTE 


USING TYPE SIZES RESPONSIBLY 

Text set in large type contrasts with text set in small type. It makes sense to use large type 
to emphasize headings and other important information. But be careful with small type. It is 
unethical (and, according to some court rulings, illegal) to use excessively small type (such as 
6-point or smaller type) to disguise information that you don't want to stand out. When you 
read the fine print in an ad for cell-phone service, you get annoyed if you discover that the 
low rates are guaranteed for only three months or that you are committing to a long-term 
contract. You should get annoyed. Hiding information in tiny type is annoying. Don't do it. 


Line Length The line length most often used on an 8.5 x 11-inch page — 
about 80 characters — is somewhat difficult to read. A shorter line of 50 to 60 
characters is easier, especially in a long document (Biggs, 1980). 

Line Spacing Sometimes called leading (pronounced “ledding”), line spacing 
refers to the amount of white space between lines or between a line of text 
and a graphic. If lines are too far apart, the page looks diffuse, the text loses 
coherence, and readers tire quickly. If lines are too close together, the page 
looks crowded and becomes difficult to read. Some research suggests that 
smaller type, longer lines, and sans-serif typefaces all benefit from extra line 
spacing. Figure 11.16 shows three variations in line spacing. 
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a. Excessive line spacing 

Aronomink Systems has been contracted by Cecil Electric Cooperative, Inc. 
(CECI) to design a solid waste management system for the Cecil County plant, 
Units 1 and 2, to be built in Cranston, Maryland. The system will consist of two 
600 MW pulverized coal-burning units fitted with high-efficiency electrostatic 
precipitators and limestone reagent FGD systems. 

b. Appropriate line spacing 

Aronomink Systems has been contracted by Cecil Electric Cooperative, Inc. 
(CECI) to design a solid waste management system for the Cecil County plant, 
Units 1 and 2, to be built in Cranston, Maryland. The system will consist of two 
600 MW pulverized coal-burning units fitted with high-efficiency electrostatic 
precipitators and limestone reagent FGD systems. 

c. Inadequate line spacing 

Aronomink Systems has been contracted by Cecil Electric Cooperative, Inc. 
(CECI) to design a solid waste management system for the Cecil County plant, 
Units 1 and 2, to be built in Cranston, Maryland. The system will consist of two 
600 MW pulverized coal-burning units fitted with high-efficiency electrostatic 
precipitators and limestone reagent FGD systems. 


FIGURE 11.16 Line Spacing 


Line spacing is usually determined by the kind of document you are writ- 
ing. Memos and letters are single-spaced; reports, proposals, and similar 
documents are often double-spaced or one-and-a-half-spaced. 

Figure 11.17 on page 270 shows how line spacing can be used to distin- 
guish one section of text from another and to separate text from graphics. 

Justification Justification refers to the alignment of words along the left 
and right margins. In technical communication, text is often left-justified (also 
called ragged right). Except for the first line in each paragraph, which is some- 
times indented, the lines begin along a uniform left margin but end on an 
irregular right margin. Ragged right is most common in word-processed text 
(even though word processors can justify the right margin). 

In justified text, also called full-justified text, both the left and the right 
margin are justified. Justified text is seen most often in formal documents, 
such as books. The following passage (U.S. Department of Agriculture, 2002) is 
presented first in left-justified form and then in justified form: 



270 


11 


DESIGNING PRINT AND ONLINE DOCUMENTS 


FIGURE 11.17 Line 
Spacing Used To Distin- 
guish One Section from 
Another 

Source: U.S. Patent and Trademark Office, 
2010: www.uspto.gov/about/stratplan 
/ar/2009/2009annualreport.pdf. 


The line spacing between two sec- 
tions is greater than the line spacing 
within a section. 


Line spacing is also used to separate 
the text from the graphics. 


Net ICostl/Inconie I Dollars in Millions) 


FY 2006 

FY 2007 

FY 2008 

FY 2009 

Earned Rovonuo 

S 1,372.8 

S 149«.« 

S 1,7357 

S 1,9622 

S 1427.1 

Program Com 

0, <24.01 

11414.2) 

IUB9.61 

(1,892.61 

1146141 

Net (Cost 1/Income 

t 15121 

S 002 

S <3391 

> 130,41 

S 154,81 


STATEMENT OE NET COST 

The Statement of Net Cost presents the LOTTO'* results of opera- 
tions by the following responsibility segments - Patent, Trademark, 
and Intellectual Property Protection and Enforcement Domestically 
and Abroad. The above table presents the total LISPTO s results 
of operations for the past five fiscal years In FY 2005, the 
LOTTO* operations resulted in a net cost. In FY 2006, the 
U5PTQ generated a net income due to the increased mainte- 
nance tees received and revenue recognition of previously 
deferred revenue collected subsequent to the fee increase on 
December 8, 2004. During FY 2007, FT’ 2008, and FY 2009 the 
LOTTO'S operation* resulted in a net cost of 133 9 million. 
130.4 milium, and >54.8 million, respectively 


tions likewise decreased, decreasing deferred revenue and 
increasing earned revenue. This was evidenced by the Patent 
organization disposing of 22.9 percent more applications than 
were disposed of during FY 2008. 

Dunng FY 2009, with the number of trademark applications 
decreasing by 12-3 percent over the prior year, the Trademark 
organization was able to continue to address the ousting 
inventory and reduce pendency by 0.3 months from FY 2008. 
The Trademark organization was able to do this while recog- 
nizing a slight decrease in revenue earned. 

• 

EARNED REVENUE 


The Statement of Net Cost compares fees earned to costs incurred 
during a specific period of time It is not necessarily an indicator 
of net income or net cost over the life of a patent or trademark. 
Net Income or net cost for the fiscal year is dependent upon 
work that has been completed over the various phases of the 
production life cycle. The net income calculation is Iwsed on 
fees earned during the fiscal year being reported, regardless of 
when those fees were collected. Maintenance fees also play a 
large part in whether a total net income or net cost is recognized 
Maintenance fee* collected in FT' 2009 are a reflection of patent 
issue levels 35, 7.5, and 11.5 years ago, rather than a reflection 
of patenLv Issued in FT’ 2009, Therefore, maintenance fees can 
hove a significant impact on matching costs and revenue. 

During FT’ 2009, with the number of patent filings decreasing by 
2.3 pcrtcnl over the prior year, the backlog far patent upplica- 

• 


The LOTTO'* earned revenue e> denved from the fees collected 
for patent and trademark products and services. Fee collections 
are recognized as earned revenue when the activities to complete 
the work associated with the fee are completed. The table below 
presents the earned revenue for the past five yearv 

Earned revenue totaled >1,927,1 million for FY 2009, an increase 
of $6-1.9 million, or 3 5 pereent, over FY 2008 earned revenue of 
>1,862.2 million. Of revenue earned dunng FY 2009, >454. 3 million 
related to fee collections dial were deferred for revenue recogni- 
tion In prior fiscal years, >546,7 million related to maintenance 
fees collected dunng FY 2009. whkh were considered earned 
immediately, >920.7 million relaled to work performed for fee* 
coil cited during FI' 2009. and >5.4 million were ltd fee-related 


1 Earned Revenue /Dollars in Millions! 

1 FY 2005 1 

FY 2006 

FY 2007 

FY 2008 


Patent 

$ 1,1978 

S 1,384.2 

S 1407.0 

S 14254 

S 1,697.4 

Percentage Change in Patent Earned Revenue 

9.6% 

156% 

19% 

7.8% 

4.5% 

Trademark 

1750 

210.2 

228.7 

237.2 

2297 

Percentage Change in Trademark Earned Revenue 

19.5% 

201% 

98% 

3.7% 

l 32/% 

Total Earned Revenue 

> 1,372.8 

S 14M.4 

S 1,735.7 

$ 1462.2 

S 1,927.1 

Percentage Change in Eemed Revenue 

10.8% 

ni% 

89% 

7.3% 

3.5% 


PERFORMANCE AND ACCOUNTABILITY REPORT. FISCAL YEAR 2009 


Notice that the space between 
words is uniform in left-justified 
text. 

In justified text, the spacing 
between words is irregular, slowing 
down the reader. Because a big 
space suggests a break between 
sentences, not a break between 
words, readers can become con- 
fused, frustrated, and fatigued. 
Notice that the irregular spacing not 
only slows down reading but also 
can create "rivers" of white space. 
Readers are tempted to concentrate 
on the rivers running south rather 
than on the information itself. 


We recruited participants to reflect the racial diversity of the area in which 
the focus groups were conducted. Participants had to meet the following 
eligibility criteria: have primary responsibility or share responsibility for cooking 
in their household; prepare food and cook in the home at least three times a 
week; eat meat and/or poultry; prepare meat and/or poultry in the home at 
least twice a week; and not regularly use a digital food thermometer 
when cooking at home. 


We recruited participants to reflect the racial diversity of the area in which 
the focus groups were conducted. Participants had to meet the following 
eligibility criteria: have primary responsibility or share responsibility for cooking 
in their household; prepare food and cook in the home at least three times a 
week; eat meat and/or poultry; prepare meat and/or poultry/ in the home at 
least twice a week; and not regularly use a digital food 
whenkookinglat home. 


thermometer 
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► TECH TIP 


HowTo Modify Line Spacing 


► TECH TIP 


HowTo Modify Justification 


When designing a page, you can adjust the white space 
between lines of text and before or after each paragraph by 
using the Paragraph dialog box and the Line Spacing drop- 
down menu. 


To increase the readability of your document, you can specify 
the alignment of words along the left and right margins 
by using the Paragraph dialog box or using buttons in the 
Paragraph group. 


in the Paragraph group, use 
the Paragraph dialog box 
launcher to display the 
Paragraph dialog box. 

in the Paragraph dialog 
box, you can change the 

spacing before and after 

paragraphs. 

You can also specify the 

line spacing, the space 
between lines of text. 



You can select preset line-spacing options by using the Line 
Spacing drop-down menu in the Paragraph group. 



To modify justification using the Paragraph dialog box, select 
the Paragraph dialog box launcher. 


You can specify that lines begin along a left margin, align at 
the right margin, are centered on the page, or are justified. 



To modifyjustification using buttons in the Paragraph group, 
select one of the following buttons: 


To left-align text 


To right-align text 


To center text 


To justify text 


KEYWORDS: line spacing, paragraph spacing, paragraph 


KEYWORDS: alignment, justify text, justification, paragraph 

group 


group 


Full justification can make the text harder to read in one more way. 

Some word processors and typesetting systems automatically hyphenate 
words that do not fit on the line. Hyphenation slows down and distracts the 
reader. Left-justified text does not require as much hyphenation as full- 
justified text. 
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For more about titling your 
document, see Ch. 9, p. 1 93. 


For more about using headings, see 
Ch. 9, p. 194. 


TITLES AND HEADINGS 

Titles and headings should stand out visually on the page because they intro- 
duce new ideas. 

Titles Because the title is the most-important heading in a document, it 
should be displayed clearly and prominently On a cover page or a title page, 
use boldface type in a large size, such as 18 or 24 points. If the title also 
appears at the top of the first page, make it slightly larger than the rest of 
the text — perhaps 16 or 18 points for a document printed in 12 point — but 
smaller than it is on the cover or title page. Many designers center titles on 
the page between the right and left margins. 

Headings Readers should be able to tell when you are beginning a new 
topic. The most effective way to distinguish one level of heading from 
another is to use size variations (Williams & Spyridakis, 1992). Most readers 
will notice a 20-percent size difference between an A head (a first-level head- 
ing) and a B head (a second-level heading). Boldface also sets off headings 
effectively. The least-effective way to set off headings is underlining, because 
the underline obscures the descenders, the portions of letters that extend 
below the body of the letters, such as in p and y. 

In general, the more important the heading, the closer it is to the left mar- 
gin: A heads usually begin at the left margin, B heads are often indented a 
half inch, and C heads are often indented an inch. Indented C heads can also 
be run into the text. 

In designing headings, use line spacing carefully. A perceivable distance 
between a heading and the following text increases the impact of the head- 
ing. Consider these three examples: 


Summary 

In this example, the writer has skipped a line between the heading and the text that 
follows it. The heading stands out clearly. 

Summary 

In this example, the writer has not skipped a line between the heading and the text 
that follows it. The heading stands out, but not as emphatically. 

Summary. In this example, the writer has begun the text on the same line as the 
heading. This run-in style makes the heading stand out the least. 


OTHER DESIGN FEATURES 

Table 11.3 shows five other design features that are used frequently in 
technical communication: rules, boxes, screens, marginal glosses, and pull 
quotes. 
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TABLE 11.3 Additional Design Features for Technical Communication 


Two types of rules are used here: 
vertical rules to separate the 
columns and horizontal rules to 
separate the items. Rules enable 
you to fit a lot of information on 
a page, but when overused they 
make the page look cluttered. 



Source: From Institute of Scientific and 
Technical Communicators, "Industry 
News" in COMMUNICATOR (Spring 
2005). Reprinted by permission of the 
Institute of Scientific and Technical 
Communicators. 


Rules. Rule is a design term for a straight line. You can 
add rules to your document using the drawing tools in a 
word processor. Horizontal rules can separate headers and 
footers from the body of the page or divide two sections of 
text. Vertical rules can separate columns on a multicolumn 
page or identify revised text in a manual. Rules exploit the 
principles of alignment and proximity. 



Boxes. Adding rules on all four sides of an item creates 
a box. Boxes can enclose graphics or special sections of 
text or can form a border for the whole page. Boxed text 
is often positioned to extend into the margin, giving it 
further emphasis. Boxes exploit the principles of contrast 
and repetition. 


Source: From J. W. Valley, "A cool early 
Earth?" from SCIENTIFIC AMERICAN 
(October 2005): 58-65. Copyright 
© 2005 by Scientific American, Inc. 
Illustrations reprinted by permission of 
Lucy Reading-lkkanda. Images used by 
permission of J.W. Valley. 


( continued ) 
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TABLE 1 1 .3 Additional Design Features for Technical Communication ( continued ) 


The different-colored screens 
clearly distinguish the three sets 
of equations. 



Screens. The background shading used behind text or 
graphics for emphasis is called a screen. The density of a 
screen can range from 1 percent to 1 00 percent; 5 to 1 0 
percent is usually enough to provide emphasis without 
making the text illegible. You can use screens with or 
without boxes. Screens exploit the principles of contrast 
and repetition. 


Source: Excerpt from W. K. Purves, D. 

Sadava, G. H. Orians, and H. C. Heller, LIFE: 
THE SCIENCE OF BIOLOGY, Seventh Edition, 
page 466. Copyright © 2004. Reprinted by 
permission of Sinauer Associates, Inc. 


The marginal glosses present 
definitions of key words. 


Marginal glosses. A marginal gloss is a brief comment 
on the main discussion. Marginal glosses are usually set 
in a different typeface — and sometimes in a different 
color — from the main discussion. Although marginal 
glosses can be helpful in providing a quick overview of the 
main discussion, they can also compete with the text for 
readers' attention. Marginal glosses exploit the principles of 
contrast and repetition. 


Source: Excerpt and sample marginal 
glosses from PSYCHOLOGY, Tenth Edition 
(New York: Worth Publishers, 2013). David 
C. Myers, page 304. 



This pull quote extends into the 
margin, but a pull quote can go 
anywhere on the page, even 
spanning two or more columns or 
the whole page. 


Puritan leaders, however, interpreted 
an error caused either by a misguided 
r by the malevolent power of Satan, 
the Cjuve. errors could 
crated As one 1'uril.in 

I”' 1 ””"; Almost from Ihe beginning, 

it hi* word tolerate ’ ^ 

states, to gtw John Wimnrop and other 
o atfvMMfctflf leaders had difficulty 
tf Owy tw. po»w w enforcing their views o( 

s to suppress them The 3 

there t> no Punlan orthodoxy. 

y after banishing Roger 
Winthtup confronted another div 
» lime — as one Newt Englander ot> 

" Wonsan that Preaches better Gospell 
af your bfack-coatrs that base been at 
rversity." The woman was Anne 
n. a devout IViriUn steeped in Scripture 
d by religious questions, 
n had received an csccUent education 

ithi r in Bari— id I hr mu’h.-r nl li.nr 


Source: Excerpt and sample pull quote from 
THE AMERICAN PROMISE: A HISTORY OF THE 
UNITED STATES, VOLUME l:TO 1 877 (Boston: 
Bedford/St. Martin's, 2005). L. Roark, M. P. 
Johnson, P. C. Cohen, S. Stage, A. Lawson, 
and S. M. Hartman, p. 1 1 5. 


Pull quotes. A pull quote is a brief quotation (usually just 
a sentence or two) that is pulled from the text, displayed 
in a larger type size and usually in a different typeface, and 
sometimes enclosed in a box. Newspapers and magazines 
use pull quotes to attract readers' attention. Pull quotes are 
inappropriate for reports and similar documents because 
they look too informal. They are increasingly popular, 
however, in newsletters. Pull quotes exploit the principles 
of contrast and repetition. 
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► TECH TIP 


HowTo Create Borders and Screens 


► TECH TIP 


HowTo Create Text Boxes 


To emphasize page elements by enclosing them in a box or 
including background shading, use the Borders and Shading 
dialog box. 


To create a border around a page element 
or an entire page, select the area you want 
to format. Select the Page Layout tab, 
and then select Page Borders in the Page 
Background group. 


0 Watermark * 
^S)Page Color’ 
|Q) Page Borders 

Page Background 




To create shading, also called a screen, select the area you 
want to format, and then select Page Borders on the Page 
Background group. Select the Shading tab. x 


You can specify the color within the box as well as the 
style of the pattern. 


To emphasize graphics or special 
sections of text or to position 
such elements independently of 
your margins, use the Text Box 
feature in the Text group on the 
Insert tab. 


To create a text box, select 

Draw Text Box from the Text 
Box drop-down menu. 



Click and drag your cursor to create your 
text box. - 

Click inside the text box and begin 
typing 

You can select the text box and move 
it around your page. 


You can also insert a built-in text 
box from the Text Box drop-down 
menu. 



To format your text box, select the box and then select the 
Format Shape dialog box launcher from the Shape Styles 
group on the Format tab. 


The Arrange 

group allows 
you to specify 
design ele- 
ments such as 
the text box's 
position in relation to other objects and the 
wrapping style of the surrounding text. 


View J Format | 

lift Text Direction » 
i Align Text * 
Create link 
Text 

pS] p^j Qj Bring Forward * £ ' 

Send Backward * 

Position Wrap „ 

* Text-* Selection Pane 

Arrange 


After select- 
ing the box, 
you can also 
use but- 
tons on the 
Format tab 

to specify such design elements as fill color, line 
color, font color, line style, and other effects. 



Shape Styles 


^ Shape Fill * 

[ Shape Outline - 
Q Shape Effects - 



KEYWORDS: borders, page borders, shading, page background 


KEYWORDS: text box, drawing toolbar, fill color, line 

group 


color 
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Analyzing Several Print-Document Designs 

Figures 11.18 to 11.21 show typical designs used in print documents. 


A multicolumn design enables you 
to present a lot of text and graphics 
of different sizes. 


Notice how the designer has used 
the whole width of the page for one 
graphic and a single column for a 
smaller graphic. 


Note that the alley — the space 
between the two columns of text — 
need not be wide. Nor do you need 
to include a vertical rule to keep 
the columns separate. The human 
brain easily understands that each 
column is a separate space. 


In this sample, the bar graph is 
exactly the width of the column 
in which it appears. But it doesn't 
have to be. It could break the shape 
of the column and extend into 
the other column or even into the 
margin. Or it could be narrower 
than its column, with the text wrap- 
ping around it. The design you see 
here looks neat and professional. If 
the graph were wider or narrower 
than the column, the design might 
appear somewhat more creative. 



Financial Discussion and Analysis 


Financial Highlights 


he USPTO received an unqualified (clean) audit 
opinion from the independent public account- 
ing firm of KPMG LLP on its FY 2012 financial 
statements, provided in the Financial Section of this 
r e port. TntKjs t he 20 l h co nsecutive year that the 
USPTO received a clean opinion. Our unqualified 
audil opinion provides Independent assurance to 
the public that the Information presented in the 
USPTO financial statements i: fairly presented. In all 
material respects, in conformity with accounting 
principles generally accepted in the United States of 
America. In addition. KPMG LLP reported no material 
weaknesses in the USPTOs internal control, and no 
instances of non-compliance with laws and regula- 
tions affecting the financial statements. Refer to the 
Other Accompanying Information section for the 
Summary of Financial Statement Audit and Manage- 
ment Assurances. 

The summary financial highlights presented in this 
section ~Drovide-an- analvsis of the information that 
appears In the USPTO's FY^oT2^hdhciQTstateme«ts>--* 
The USPTO financial management process ensures 
that management decision-making information is 
dependable, internal controls over financial reporting 
are effective, and that compliance with laws and 
regulations is maintained. The issuance of these 
financial statements is a component of the USPTO s 
objective to continually improve the accuracy and 
usefulness of its financial management Information. 


Balance Sheet and Statement of Changes in 
Net Position 

At the end of FY 2012. the USPTO s consolidated 
©Balance Sheet presents total assets of SI. 982.1 
million, total liabilities of $1,255.2 million, and a net 
position of $726.9 million. 

Total assets increased 20.3 percent over the last four 
years, resulting largely from the increase In Fund 
Balance with Treasury, The decrease In Fund Balance 
with Treasury during FY 2009 is a result of the 
decrease in fee income. The following graph shows 
the changes in assets during this period, 


Composition of Assets 

(Dollars In Millions) 


S1JOO 0,000 

I FY 2009 ■ FY 2008 


FIGURE 11.18 A Multicolumn Design 

Source: U.S. Patent and Trademark Office, 201 3: http://www.uspto.gov/about/stratplan/ar/USPTOFY201 2PAR.pdf. 
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PDF Page Content 


PDF is a page description language, i.e. it describes how a page looks so that it can be 
reproduced for viewing and printing. The language resembles Postscript, but is much sim- 
pler to allow for more efficient processing. For example, it does not contain control struc- 
tures like loops and. If" statements. 


PDF Page Content Elements 

Basically PDF recognizes three types of 
page content elements: 

Text (fonts programs) 

Graphic paths (lines and curves) 
Images (raster samples) 

The picture to the right shows examples 
of the three PDF content types. 



Content Objects 

PDF uses objects and object types to describe the content. Every string of text and all 
graphics and images are defined by one or several objects, created from one or more 
object types. 

Text Objects. Text objects are defined by a number of attributes including font family, 
style and size, a string of characters, and a position on a page. PDF does not recognize 
nor store objects for line breaks, headers, paragraphs, indentation etc. (I.e. paragraph 
formatting operators used in word processing applications like Microsoft Word). Text is 
broken down into fragments as small as single characters but not more than one line. 
The fragments can be randomly stored and are like pieces of a puzzle that all have to be 
placed in their correct location on the page to complete its appearance. 

Graphic Path Objects. A graphic path object is an arbitrary shape made up of straight 
lines, rectangles, and cubic Bezier curves. A graphic path object ends with one or more 
painting operators that specify whether the path is stroked, filled, used as a clipping 
boundary or some combination of these operations. 

PDF Image Objects. A PDF-specific image format is used for embedding images in a PDF 
file. This format Is independent of the input image format. For example, scanned pages 
in TIFF format or GIF images that are converted to PDF are newly packaged into PDF 
image format. Once an image has been converted to PDF image format, it is usually not 
possible to determine what the original image format was. It is however possible to 
export PDF images into raster image formats, provided the raster image format supports 
all features of the image (e.g. transparency). 


Unlike word processors, text is 
not continuous In a paragraph. 

Text Is defined in fragments with 
attributes such as font and font 
size, a string of characters and a 
location on a page. 


Images that are imported into a 
PDF file are converted to PDF 
image format. They are not 
stored as TIFF, GIF etc. images. 


This page from a software com- 
pany's white paper — a marketing 
document usually distributed on 
the web — shows one approach to a 
one-column design. 


The main text column is relatively 
narrow, making the line easy to 
read. 


The right margin is wide enough 
to accommodate text boxes, small 
graphics, or other items. 


One goal of document design is 
to reduce the number of pages 
needed — but when you design a 
page, you want to make the text 
inviting and easy to read. Figuring 
out how to balance these two 
priorities is one of the major chal- 
lenges of designing a page. 


FIGURE 11.19 A One-Column Design 

Courtesy of PDF Tools AG. 
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This is a page from State, the 
magazine for employees of the U.S. 
State Department. Magazines for 
people who work together tend to 
include a lot of photographs, includ- 
ing many showing people from that 
organization. 


The large photograph extends to 
the top edge and the left edge of 
the page. Eliminating the margins 
in this way would be a mistake if 
the graphic were crammed with 
information that readers needed 
to study; a dense table of data, for 
instance, would be overwhelming. 
But in this case, the blue sky in the 
background acts as a decorative 
frame for the "information" in the 
bottom half of the photo. 


inspection in Antarctica, were called for 
in an agreement that Secretary of State 
Hillary Rodham Clinton signed with 
Russian Foreign Minister Sergey l-avrov 
in September 2012. The United States 
and Russia were architects of the Antarctic 
T reaty of 1 959 and today conduct some 
of the most extensive and diverse scientific 
activities in Antarctica. Importantly, both 
countries reject territorial claims by other 
parties and arc strong supporters of the 
Antarctic Treaty system, Working closely 
with our Russian counterpans provided 
an excellent opportunity to reinforce our 
shared objectives ior the peace and science in 
Antarctica. The results of the inspection will 
be presented to all treat)' parties at the May 
Antarctic Treaty Consultative Meeting. 

Antarctica is an outstanding example of 
multilateral diplomatic success. Fifty years 
after the signing of the Antarctic T reaty, the 
continent is a global example of policy and 
scientific collaboration. The multinational 
science conducted in Antarctica informs 
global understanding of the Earth's history, 
processes and change, and policy and 
logistical cooperation there creates stronger 
ties among treaty parties. In the coming 
decades, the Antarctic Treaty system will 
continue to prove the resilience and value of 
multilateral cooperation. □ 


Although this page uses a simple 
three-column design, note that 
one photo spans all three columns, 
another photo spans two columns, 
and the caption box spans one col- 
umn. This creative use of the multi- 
column design enables the designer 
to fill the page with content while 
keeping it visually interesting. 


inspections in East Antarctica required the 
team to travel more than 3,500 miles over six 
days by plane, truck, boat, helicopter, tracked 
vehicle and snowmobile. 

The inspections, representing the first 
time either country had conducted a joint 


FIGURE 11.20 A Magazine Page Design 

Source: U.S. Department of State, 2013: www.state.gov/documents/organization/205362.pdf. 
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(f) Drug Purity - DEA Form 7 

(1) The presentence report will normally provide drug weight/purity information from DEA Form •— 
7. This is a complicated form. "Total net weight" [normally in Item 31 J refers to the amount of the 
pure drug. This is the weight used in calculation of the Commission's severity rating. For your 
information, "gross weight" is the weight of the drug phis adulterants plus the container (normally 
found in Item 24). Also normally found in Item 24 is "net weight" (the weight of the drug plus 
adulterants). "Strength" (the percent purity of the drug) is normally found in Item 28. Multiplying 
"net weight" x "strength" is how DEA arrives at the "total net weight". Remember, "total net weight" 
is the weight of the pure drug to be used in assessing the Commission’s severity rating. 


(2) If a presentence report does not specify "total net weight", the probation officer should be •— 
contacted for clarification (please be specific as to the clarification necessary; this will enhance 
feed hack/training). Note: DEA lab reports (DEA Form7), if necessary, also may be obtained directly 
from the DEA field office for the geographic area in which the offense occurred. If a request to the 
DEA fieldoffice is required, provide the subject’s name, date ofbirth, place ofoffense, and dates of 
offense. 

(g) If neither weight nor purity is available, but only a money value, DEA may be requested to 
provide an estimate oft he amount of pure drug associated with that money value. In the absence of 
a specific estimate from DEA pertaining to the particular case, DEA publishes a report (Domestic 
Drug Prices) providing estimates of average drug prices by year and region from which an estimate 
may be obtained. 

(h) Determining Offense Sewrity Relative to Sim[)le Possession of Drugs. In certain cases, the 
Commission must determine whether the offense behavior should be considered as "simple 
possession" of a controlled substance or "possession with intent to distribute." In making this 
determination, the Commission shall examine a variety of factors (if available). These factors are 
shown below. The presence of any of the following factors may be considered as a presumption of 
possession with intent to distribute. However, this presumption may be rebutted if there are 
circumstances in the individual case which indicate that there was no intention to distribute. 

(1) Weight/amount/purity of the substance : Possession of the following amounts of controlled 
substances arc presumed to indicate possession with intent to distribute 


Heroin 1 gm. at 100% purity or equivalent amount; or more 

Cocaine 5 gms. at 1 00% purity, or equivalent amount; or more 

Marijuana 10 lbs. or more 

Hashish 3 lbs. or more 

Hash Oil .3 lbs. or more 

Drugs (other titan above) 1,000 doses or more. 

(2) Other Factors: The presence of any of tlte following factors may be considered indicative of 
intent to distribute: (A) tlte substance has been separated into multiple, individual packets; (B) the 
offender Is a non-user of the substance in question; (C) the presence of instruments used in preparing 


•Terms marked by an atlcritkirc d«riniil in Chapter Thirteen. 


1 1/15X17 Pago 60 of 337 •- 


The writer of this document hasn't 
designed the page. He or she has 
simply hit the Enter key repeatedly. 


The full justification makes for a 
boxy appearance and irregular 
spacing between words. 

The wide column results in long, 
difficult-to-read lines. 


The two hierarchical levels — 
numbered and lettered — have the 
same design and therefore are dif- 
ficult to distinguish from each other. 


In the table, the second column is 
misaligned. 


The footer, which includes the date 
and the page number, is a useful 
design feature, however. 


FIGURE 11.21 A Poorly Designed Page 

Source: U.S. Department of Justice, 2010: www.justice.gov/uspc/rules_procedures/uspc-manual1 1 1507.pdf. 
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DOCUMENT ANALYSIS ACTIVITY 


Analyzing a Page Design 


This page is from a government 
report. The questions below ask 
you to think about page design 
(as discussed on pp. 260-75). 

1. How many levels of head- 
ings appear on this page? 
Are the different levels 
designed effectively so that 
they are easy to distinguish? 
If not, what changes would 
you make to the design? 

2 . How are rules used on this 
page? Are they effective? 
Would you change any of 
them? 

3 . Describe the design of the 
body text on this page, 
focusing on columns and 
alignment. Is the design 
of the body text effective? 
Would you change it in any 
way? 


20 the muon vo economic oihooe nst.v vecbs ion to iojc 


ITBB cm J013 


Figure 1-2. 

Total Revenues and Outlays 

(Percentage of gross domestic product) 



Source: Congressional Budget Office. 

health care costs, and a significant expansion in eligibility 
for federal subsidies for health insurance, outlays for 
Social Security and the federal government's major health 
care programs arc projected to rise substantially relative to 
the size of the economy over the next 10 years. In addi- 
tion. growing debt and rising interest rates will boost net 
interest payments. Spending on all other programs — in 
l ^e aggregate — is projected to decline relative to GDP 
between 2014 and 2023, primarily because of improving 
economic conditions and the spending limits in current 
law. 

Revenues 

CBO projects that, if current tax laws remain unchanged, 
revenues will rise relative to GDP over the next two years 
and then remain at about 19 percent of GDP through 
2023. After 2015, increases in individual income tax 
receipts relative to GDP will roughly offset projected 
declines in corporate income tax receipts and declines in 
remittances from the Federal Reserve as a share of GDP. 

Individual Income Taxes. CBO projects that, under cur- 
rent law, individual income tax receipts will rise from 
$1.3 trillion this year to $2.5 trillion in 2023— or from 
7.9 percent to 9.8 percent of GDP The projected 
increase in receipts relative to the economy in CBO s 
baseline reflects real (inflation-adjusted) bracket creep, 
the economic expansion, recent and scheduled changes in 
tax provisions, and other factors. In previous baselines. 


CBO had projected that those receipts would increase to 
a much higher percentage of GDP by the early pan of 
the next decade, but the American Taxpayer Relief Act's 
permanent extension of most of the expiring income 
tax reductions has significandv reduced the amount of 
revenues anticipated under cunent law. 

Real Bracket Creep. Increases in real income will push 
more income into higher tax brackets, which boosts 
revenues relative to GDP in CBO’s projections by 
0.9 percentage points over the next decade." 

Economic Recovery. CBO expects that the economic 
expansion and related factors will cause taxable incomes 
to rise faster than GDP. boosting individual income tax 
revenues as a share of GDP by about 0.4 percentage 
points over the next decade: most of that effect will occur 
by 2017. Certain components of taxable income — 
including wages and salaries, capital gains realizations, 
interest income, and proprietors' income — declined as a 
share of GDP over the past several years. CBO expects 
that, as the economy recovers, such income will rebound 
more quickly than the economy as a whole, increasing 


II. Roughly three -quirten of that amount is a longer-term effect that 
results from increases in the potential output of the economy (that 
is. the maximum sustainable loci of economic output), and the 
rest results from the mum of output to its potential level over 
the next several yean. 


Source: U.S. Congressional Budget Office, 2013: www.cbo.gov/sites/default/files/cbofiles/attachments/43907-BudgetOutlook 
.pdf. 
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Designing Online Documents 

The previous discussion of designing printed documents focused on four compo- 
nents: size, paper, bindings, and accessing aids. Of these four components, size 
and accessing aids or tools are relevant to websites and other online documents. 

Size is important in that you can control — to some extent, at least — how 
much information (text, graphics, animation) you assign to the screen. On all but 
the smallest screens, you can use multiple columns and vary column width, and 
you can fill screens with content (and thereby use fewer screens) or leave a lot of 
white space (and thereby use more screens). As people are increasingly turning 
to smaller screens for reading online content, you want to pay more attention 
to designing your information so that it is clear and attractive. You also want 
to be sure that you design the site so that key information is emphasized and 
easily accessible to users. In addition, you want to consider audience character- 
istics such as age (use bigger type for older people) and disabilities (for example, 
include text versions of images so that people with vision disabilities can use 
software that “reads” your descriptions of the images). 

Accessing tools are vitally important, because if your audience can’t figure 
out how to find the information they want, they’re out of luck. With a print 
document, they can at least flip through the pages. 

The following discussion focuses on seven principles that can help you 
make it easy for readers to find and understand the information they seek: 

• Use design to emphasize important information. 

• Create informative headers and footers. 

• Help readers navigate the document. 

• Include extra features your readers might need. 

• Help readers connect with others. 

• Design for readers with disabilities. 

• Design for multicultural readers. 

Although some of these principles do not apply to every type of online docu- 
ment, they provide a useful starting point as you think about designing your 
document. 

USE DESIGN TO EMPHASIZE IMPORTANT INFORMATION 

The smaller the screen, the more cluttered it can become, making it difficult 
for readers to see what is truly important. In documents designed to be viewed 
on different-sized screens, you want readers to be able to find what they want 
quickly and easily. As you begin planning a site, decide what types of infor- 
mation are most essential for your audience, and ensure that that content in 
particular is clearly accessible from the home screen. Give your buttons, tabs, 
and other navigational features clear, informative headings. For more guidance 
on emphasizing important information, see Chapter 9. 

Once you have determined the information you want to emphasize, 
adhere to design principles rigorously so that users can easily identify key 
content. Use logical patterns of organization and the principles of proxim- 
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FIGURE 11.22. Screen 
for a Mobile Application 

Sepsis Clinical Guide mobile app, 
Escavo, Inc. (www.escavo.com). Used by 
permission. 


8 5:21 AM 
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This app helps physicians diagnose sepsis quickly 
and effectively. The information most crucial to 
evaluating the condition is easily accessible on 
the home screen. At the top of the screen, where 
the reader's eyes will initially fall, is an overview 
of the condition and, most importantly, the diag- 
nostic tool. Less-essential items, such as resources 
and references, are located at the bottom of the 
screen. Supplementary information, such as a call 
for authors and a feedback form, is deeper on the 
site, behind the "More" tab. 


This simple screen uses the principle of contrast 
effectively to highlight key content. Each of the 
eight main content areas has its own color and its 
own icon to distinguish it from the seven other 
areas. In addition, the four navigation items at 
the bottom of the screen use contrast in that the 
screen the reader is now viewing — in this case, 
the home page — is presented against a blue 
screen, whereas the other three are presented 
against a black screen. 


ity, alignment, repetition, and contrast so that readers know where they are 
and how to carry out the tasks they want to accomplish. Figure 11.22 shows a 
well-designed screen for a mobile phone. 

CREATE INFORMATIVE HEADERS AND FOOTERS 

Headers and footers help readers understand and navigate your document, 
and they help establish your credibility. You want readers to know that they 
are reading an official document from your organization and that it was cre- 
ated by professionals. Figure 11.23 shows a typical website header, and Figure 
11.24 shows a typical footer. 



FIGURE 11.23 Website Header 

Notice that a header in a website provides much more accessing information than a header in a printed 
document. This header enables readers to search the site, as the header on almost every site does, but it also 
includes other elements that are particularly important to the Michael J. Fox Foundation. For instance, there is a 
link to drug trials that visitors might want to join, and there is a prominent link for donating to the foundation. 
Reprinted by permission of the Michael J. Fox Foundation for Parkinson's Research. 
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The Michael J. Fox Foundation for Parkinson's Research. Grand Central Station, P.O. Box 4777, New York, NY 10163-4777. Tel: 1-800-708-7644 
Copyright © 2013 Michael J. Fox Foundation. Privacy Policy | Terms & Conditions | Sitemap 


FIGURE 11.24 Website Footer 

This simply designed footer presents all the links as text. Readers with impaired vision who use text-to-speech 
devices will be able to understand these textual links ; they would not be able to understand graphical links. 
Reprinted by permission of the Michael J. Fox Foundation for Parkinson's Research. 


The top line of the footer contains 
the contact information for the site. 
The bottom line contains the 
copyright notice, as well as links to 
the privacy policy, the terms and 
conditions for using the site, and a 
site map. 


HELP READERS NAVIGATE THE DOCUMENT 

One important way to help readers navigate is to create and sustain a 
consistent visual design on every page or screen. Make the header, footer, 
background color or pattern, typography (typeface, type size, and color), and 
placement of the navigational links the same on every page. That way, read- 
ers will know where to look for these items. 
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Making Your Document Easy To Navigate 


Follow these five suggestions to make it easy for readers to find what they want in 
your document. 


► Include a site map or index. A site map, which lists the pages on the site, can be a 
graphic or a textual list of the pages, classified according to logical categories. An 
index is an alphabetized list of the pages. Figure 1 1 .25 shows a portion of a site map. 


J^icron 

(0 UcronOloCsl Investor Relelwta 
PRODUCTS & SUPPORT ABOUT MICRON 

News « Events Jots Contact Micron How lb Buy 
Leg* Sign up tor Acceee 

Enter Search Term or Part Number ► 





Site Map 



Log* or Register to 

GCMI > SteUap 



O Save lo Workspace d 

Products 

Support 

Applications 

About Micron 

• DRAM 

• Contact Us 

• Ultrathin 

. U, Micron 

• DRAM Modules 

• How to Buy 

• Automotive 

• Our Company 

• NANO Flash 

• Technical Notes 

• Personal Systems 

• News & Everts 

• Managed N4.ND 

• Customer Service Notes 

• Mobile 

• Blogs 

• NOR Flash 

• Obsolete Parts 

• Networking 

• Jobs 

• Solid Stale Storage 

• Part Numbering Guides 

• Servers 

• moon Foundation 

• Mufflchip Packages 

• General FAQ* 

• Graphics and Consumer 

• Ionovas ona 

• Phase Change Memory 



• Locations 

t Hybrid Memory Cube 



• Our Commitment 




• Investor Relations 


FIGURE 11.25 Site Map 

For large websites, help your readers by organizing the site map rather than just presenting an 
alphabetical list of the pages. In this portion of a site map, Micron Technology classifies the 
pages in logical categories to help visitors find the pages they seek. 

Copyright © Micron Technology, Inc. All rights reserved. Reprinted by permission. 


( continued ) 
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► Use a table of contents at the top of long pages. If your page extends for 
more than a couple of screens, include a table of contents — a set of links to 
the items on that page — so that your readers do not have to scroll down to 
find the topic they want. Tables of contents can link to information farther 
down on the same page or to information on separate pages. Figure 1 1 .26 
shows an excerpt from the table of contents at the top of a frequently asked 
questions (FAQ) page. 


STOPfakesgov^ 


Your resource for IPR information and assistance 


HOMt ABOUI SIOI'FAKhS KFSOURCLS FAQS CQNIACl IJS 


FAQs 


» How Oo I Protect My Intellectual Property in the U.S? 

How can I protect my business from Intellectual property theft? 

How should I protect my Intellectual property? 

How long does patent, trademark or copyright protection last? 

Do 1 need to file for protection overseas? 

How else can I protect my copyright and/or trademark? 

• How Do I Protect My Intellectual Property Abroad? 

How can I prevent Intellectual property theft abroad? 

Do I need to file for protection overseas? 

How do I register my trademark, patent, or copyright abroad? 

How do I enforce my Intellectual property rights In a foreign country? 
How can I check the credentials of a potential foreign business partner? 


Find the best office to 
help you. 


a 


China IPR /o. 

Webinar Series 


IPR Training s~i. 

Module 


FIGURE 11.26 Table of Contents 

The table of contents is classified by topic (first all the topics about protecting your intellectual 
property in the United States, then all the topics about protecting it outside the United States). 
For any online document, large or small, use the principles of organizing information 
presented in Chapter 8. 

Source: U.S. Department of Commerce, 201 3: www.stopfakes.gov/faqs. 


► Help readers get back to the top of long pages. If a page is long enough to 
justify a table of contents, include a "Back to top" link (a textual link or a button or 
icon) before the start of each new chunk of information. 

► Include a link to the home page on every page. This link can be a simple "Back to 
home page" textual link, a button, or an icon. 

► Include textual navigational links at the bottom of the page. If you use 

buttons or icons for links, include textual versions of those links at the 
bottom of the page. Readers with impaired vision might use special software 
that reads the information on the screen. This software interprets text only, 
not graphics. 
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INCLUDE EXTRA FEATURES YOUR READERS MIGHT NEED 

Because readers with a range of interests and needs will visit your site, con- 
sider adding some or all of the following five features: 

• An FAQ page. A list of frequently asked questions helps new readers by 
providing basic information, explaining how to use the site, and directing 
them to more-detailed discussions. 

• A search page or engine. A search page or search engine enables readers 
to enter a keyword or phrase and find all the pages in the document that 
contain it. 

• Resource links. If one of the purposes of your document is to educate 
readers, provide links to other sites. 

• A printable version of your site. Online documents are designed for a 
screen, not a page. A printable version of your document, with black text 
on a white background and all the text and graphics consolidated into one 
big file, will save readers paper and toner. 

• A text-only version of your document. Many readers with impaired vision 
rely on text because their specialized software cannot interpret graphics. 
Consider creating a text-only version of your document for these readers, 
and include a link to it on your home page. 

HELP READERS CONNECT WITH OTHERS 

Organizations use their online documents, in particular their websites, to 
promote interaction with clients, customers, suppliers, journalists, govern- 
ment agencies, and the general public. For this reason, most organizations 
use their sites to encourage their various stakeholders to connect with them 
through social media such as discussion boards and blogs. 

Use your online document to direct readers to interactive features of your 
own website, as well as to your pages on social-media sites such as Facebook or 
Twitter. Figure 11.27 on page 286 shows a portion of NASA’s community page. 

DESIGN FOR READERS WITH DISABILITIES 

The Internet has proved to be a terrific technology for people with disabilities 
because it brings a world of information to their devices, enabling them to 
work from home and participate in virtual communities. However, most sites 
on the Internet are not designed to accommodate people with disabilities. 

The following discussion highlights several ways to make your online 
documents easier for people with disabilities to use. Consider three main 
types of disabilities as you design your site: 

• Vision impairment. People who cannot see, or cannot see well, rely on text- 
to-speech software. Do not rely on color or graphics alone to communicate 
information — provide either a text-only version of your document or textual 
equivalents of all your graphics. Use the “alt” (alternate) tag to create a 
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Connect and Collaborate 
With NASA 


Social Media 

NASA Social 

Blogs 

Hangouts 

Chats 

Apps 

e-Books 

RSS Feeds 

Sounds 


Connect & Collaborate with NASA 

Social Media. Apps. e 8ooks and more 


Social Media at NASA 



(• 





Follow, share, and be a part of the conversation on popular social media sites with NASA. Join us on our flagship accounts: 


f Is 


+ 1 You 




Or join us on one of our many other accounts: 
NASA Television 
NASA en esparto) m 
NASA Social 


Navigate: Agency Accounts | NASA Centers & Facilities | Organizations & Programs | Missions & Topics | People 


NASA Centers & Facilities 


Ames Research Center 
Oryden Flight Research Center 


□DESS 0 
□□D5E9 


FIGURE 1 1 .27 Maintaining Communities 

As a federal agency with a mission that includes public education, NASA has a robust social-media presence. 
NASA has dozens of accounts on Facebook and the other popular social-media platforms, and it offers many 
opportunities for scientists and the general public alike to stay connected through blogs, podcasts, chat rooms, 
and educational programs and activities on such topics as how to view the International Space Station. 

Source: National Aeronautics and Space Administration, 201 3: www.nasa.gov/socialmedia/. 


textual label that appears when the reader holds the mouse over the graphic. 
For example, if you use a red icon to signal a warning, also use the word 
warning. Use 12-point or larger type throughout your site, and provide audio 
feedback — for example, having a button beep when the reader presses it. 

• Hearing impairment. If you use video, provide captions and, if the video 
includes sound, a volume control. Also use visual feedback techniques; for 
example, make a button flash when the reader presses it. 

• Mobility impairment. Some people with mobility impairments find it easier 
to use the keyboard than a mouse. Therefore, build in keyboard shortcuts 
wherever possible. If readers have to click on an area of the screen using a 
pointing device, make the area large so that it is easy to see and click on. 

DESIGN FOR MULTICULTURAL AUDIENCES 

About 75 percent of the people using the Internet are nonnative speakers of 
English, and that percentage continues to grow as more people from develop- 
ing nations go online (Internetworld Stats, 2013). Therefore, it makes sense 
in planning your online documents to assume that many of your readers will 
not be proficient in English. 
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Planning for a multicultural website is similar to planning for a multicul- 
tural printed document: 

• Use common words and short sentences and paragraphs. 

• Avoid idioms, both verbal and visual, that might be confusing. For instance, 
don’t use sports metaphors, such as full-court press, or a graphic of an 
American-style mailbox to suggest an email link. 

• If a large percentage of your readers speak a language other than English, 
consider creating a version of your site in that language. The expense can be 
considerable, but so can the benefits. 


ETHICS NOTE 


DESIGNING LEGAL AND HONEST ONLINE DOCUMENTS 

You know that the words and images that you see on the Internet are covered by copyright, 
even if you do not see a copyright symbol. The only exception is information that is in the 
public domain either because it is not covered by copyright (such as information created by 
entities of the U.S. federal government), because copyright has expired (the author has been 
dead over 70 years), or because the creator of the information has explicitly stated that the 
information is in the public domain and you are free to copy it. 

But what about the design of a site? Almost all web designers readily admit to spending a 
lot of time looking at other sites and pages for inspiration. And they admit to looking at the 
computer code to see how that design was achieved. This is perfectly ethical. So is copying 
the code for routine elements such as tables. But is it ethical to download the code for a whole 
page, including the layout and the design, and then plug in your own data? No. Your responsi- 
bility is to create your own information, then display it with your own design. 


Designing Online Pages 

Well-designed online pages are simple, with only a few colors and nothing 
extraneous. The text is easy to read and chunked effectively, and the links are 
written carefully so readers know where they are being directed. 

AIM FOR SIMPLICITY 

When you create an online document, remember that readers are increas- 
ingly likely to use it on a device with a small screen. In addition, they will 
likely read in noisy, distracting environments with too much light or not 
enough light. For these reasons, keep the design as simple as you can. 


4 \ 


GUIDELINES 


Designing a Simple Site 


Follow these four suggestions to make your design attractive and easy to use. 


► Use simple backgrounds. A plain background is best. Avoid busy patterns that 
distract the reader from the words and graphics of the text. 


For more about copyright law, see 
Ch. 2, p. 24. 


( continued ) 
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► Use conservative color combinations to increase text legibility. The greater the 
contrast between the text color and the background color, the more legible the 
text. The most legible color combination is black text against a white back- 
ground. Bad idea: black on purple. 

► Avoid decorative graphics. Don't waste space using graphics that convey no 
useful information. Think twice before you use clip art. 

► Use thumbnail graphics. Instead of a large graphic, which takes up space, requires 
a long time to download, and uses up your reader's data-download allotment, use 
a thumbnail that readers can click on if they wish to open a larger version. 


MAKE THE TEXT EASY TO READ AND UNDERSTAND 

Online pages are harder to read than paper documents because screen reso- 
lution is less sharp. 


For more about chunking, see p. 260. 




GUIDELINES 


Designing Easy-To-Read Text 


Follow these three suggestions to make the text on your sites easy to read. 


► Keep the text short. Poor screen resolution makes reading long stretches of text 
difficult. In general, pages should contain no more than two or three screens of 
information. 


► Chunk information. When you write for the screen, chunk information to make it 
easier to understand. Use frequent headings, brief paragraphs, and lists. 

► Make the text as simple as possible. Use common words and short sentences to 
make the information as simple as the subject allows. 


CREATE CLEAR, INFORMATIVE LINKS 

Well-phrased links are easy to read and understand. By clearly indicating 
what kind of information the linked site provides, links can help readers 
decide whether to follow them. The following guidelines box is based on Web 
Style Guide Online (Lynch & Horton, 2011). 


4 \ 


GUIDELINES 


Writing Clear, Informative Links 


Links are critically important. Follow these three suggestions to make them easy to 
use. 


► Structure your sentences as if there were no links in your text. 

awkward to go to the Rehabilitation Center page, which links 

to research centers across the nation. 

smooth The Rehabilitation Center page links to research centers across 

the nation. 


( continued ) 
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► Indicate what information the linked page contains. Readers get frustrated if 
they wait for a web file to download and then discover that it doesn't contain the 
information they expected. 

uninformative See the Rehabilitation Center . 

informative See the Rehabilitation Center's urs of operation . 

► Use standard colors for text links. Readers are used to seeing blue for links 
that have not yet been clicked and purple for links that have been clicked. If 
you have no good reason to use other colors, stick with the ones most readers 
expect. 


Analyzing Several Online-Document Designs 

The best way to learn about designing websites and their pages is to 
study them. Figures 11.28 to 11.30 offer examples of good web page 
design. 


Nobody likes user agreements, and few people read 
them carefully. Linkedln, the online professional 
network, uses a simple table design to make its user 
agreement a little easier to read. 


In this excerpt, the left column presents a simple 
overview of a portion of the agreement. The right 
column presents the "small print": the specific 
provision, including links to even more detailed 
information. 


4. Our Rights & Obligations 


We may change or discontinue 
Services, and in such case, we do not 
promise to keep showing or storing 
your information and materials 


A. Services Availability 

For as long as Unkedin continues to oner the services. Linkedln sftan provide and seek to 
update improve and expand the Services As a result we alow you lo access Lmkedin as a may 
exist and be available on any given day and we nave no other obligations, except as expressly 
stated m Vus Agreement We may modify replace refuse access to suspend or discontinue 
Lmkedin partially or entirely, or change and modify prices prospectively for all or part ot the 
Services for you or for all our Members in our sole discretion All ot these changes shall be 
elective upon their posting on Linkedln or by direct communication to you unless otherwise 
noted Linkedln furtner reserves the right to witnhokJ, remove or discard any content available as 
part of your account, with or without notice if deemed by Lmkedin to be contrary to this 
Agreement For avoidance of doubt. Lmkedin has no obftgahon to store, maintain or provide you 
a copy of any content that you or other Members provide when using the Services 


Third parlies may offer their own 
products and services through 
Linkedln, and we are not responsible 
for these third-party activities. 


B. Third Party Sites and Developers 

Unkedin may include links ro third party web sties ('Third Party Sites') on www lmkedin com 
developer lmkedin com and elsewhere Lmkedin also enables third party developers ('Plalto/m 
Developers*) lo create applications ( Platform Applications*) that provide features and 
functionality using data and developer loots made available by Lmkedin through its developer 
platform You are responsible for evaluating whether you want to access or use a Third Party Site 
or Platform Application You should review any applicable lerms or pnvacy policy of a Thmi Patty 
Site or Platform Application before using it or sharing any information ivrth it. because you may 
give the third-party permission to use your information m ways we would not Lmkedin is not 


FIGURE 1 1 .28 Making the Small Print a Little Larger 

Source: Linkedln, 201 3: http://www.linkedin.com/legal/user-agreement. 
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The About NIH page on the National 
Institutes of Health website conveys 
its message simply but effectively. 


U.S. Department of Health & Human S 




National Institutes of Health 

Turning Discovery Into Health 


For Employees Staff Directory En EspaAol 


The top row is reserved for the 
name of this government agency. 



Below the agency's name is the 
main navigation pane, beginning 
with "Health Information." 



Below the main navigation pane is 
the navigation pane for the section 
in which this page appears: "About 
NIH."The About NIH page has 18 
sections, beginning with "Mission." 


Health Information Grants & Funding 

News & Events 

Research & Training 

Institutes at NIH 

About NIH 


ABOUT NIH 


About NIH 
Mission 

Impact of NIH Rosoarch 

ThoNIHOIroetor 

Organization 

Budg«t 

History 

Jobs at NIH 

Imaj* Bank 


The National Institutes of Health (NIH), a part of the U.S. Department of Health and 
Human Services t5* , Is the nation's medcat research agency-maidng Important 
discoveries that Improve health and save lives. 

Thanks In large part to NIH-funded medical research. Americans today are Bvlng longer 
and healthier. Life expectancy In the United States has jumped from <17 years in 1900 
to 78 years as reported in 2009, and dlsabMty in people over age OS has dropped 
dramatically in the past 3 decades. In recent years, nationwide rates of new diagnoses 
and deaths from ail cancers combined have falen significantly. 


NIH at a Glance 
NIH Facts 

Common Questions 
Mission a Cods 



NIH Director 

Francis S. Colins. M.D., Ph.O. 


Headquarters 
Bethesda, Maryland, USA 


SCIENTIFIC LEADERSHIP 


Explore NIH - a virtual tour 


Frequently Asked Questions 
The NIH Almanac 
Visitor Information 
Visitor Tours 
Visitor Parking 


NIH Is the largest source of funding for medical research in the world, creating 
hundreds of thousands of high-quality jobs by funding thousands of sdendsts In 
universities and research institutions in every state across America and around the 
globe. 


NIH is made up of 27 Institutes and Centers, each with a specific research agenda. 


xplore NIH 


BBS 


FIGURE 11.29 An About Us Page 

Source: U.S. Department of Health and Human Services 


Your Art, an app from the U.S. National Gallery 
of Art, enables museum visitors — and anyone 
with an Internet connection — to see and learn 
about many of the art treasures displayed in the 
museum. The app includes numerous features, 
including news about exhibitions, textual com- 
mentary, and audio commentary. 

All of the paintings presented in the app are 
shown on screens with the same design, making it 
easy for people to learn howto find the informa- 
tion they seek. Note that the design of the screen 
is simple and familiar icons are used for manipulat- 
ing the size of the text and of the image and for 
playing the audio. Despite the small size of the 
screen, users will find it easy to navigate and use 
the app. 



0:00/2:26 


< Ginevra do’ Benci 


Ginevrtt de' Benci, c. 1474/1478 
Vinci, Leonardo da, (Italian). 1452-1519 
13th- to 16th’Ccmuiy Italian ami Spjtmh 

Vil« rtf ,,<.*»l,l»i< !• Irtf^il * i rtrt 

9 Gallery 6 Q Zoom in <xA Text Size 


FIGURE 1 1.30 An App Designed for a Small Screen 

Source: National Gallery of Art, 201 3: http://apps.usa.gov/yourart.shtml. 
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WRITER'S CHECKLIST 


Did you 

EE analyze your audience: their knowledge of the subject, 
their attitudes, their reasons for reading, and the kinds of 
tasks they will be carrying out? (p. 254) 

EE consider the purpose or purposes you are trying to 
achieve? (p. 255) 

{ I determine your resources in time, money, and 

equipment? (p. 255) 

Designing Print Documents and Pages 

Did you 

consider the best size for the document? (p. 256) 

" ' consider the best paper? (p. 256) 

EE consider the best binding? (p. 256) 

EE think about which accessing aids would be most 

appropriate, such as icons, color, dividers and tabs, and 
cross-reference tables? (p. 256) 

□ use color, if available, to highlight certain items, such as 
warnings? (p.258) 

EE devise a style for headers and footers? (p. 259) 

{ I devise a style for page numbers? (p. 259) 

I draw thumbnail sketches and page grids that define 

columns and white space? (p. 262) 

1 choose typefaces that are appropriate for your subject? 
(p. 265) 

□ use appropriate styles from the type families? (p. 266) 

□ use type sizes that are appropriate for your subject and 
audience? (p. 268) 

] choose a line length that is suitable for your subject and 

audience? (p. 268) 

EE choose line spacing that is suitable for your line length, 
subject, and audience? (p. 268) 


EE consider whether to use left-justified text or full-justified 
text? (p. 269) 

I ] design your title for clarity and emphasis? (p. 272) 

I devise a logical, consistent style for each heading level? 

(p. 272) 

□ use rules, boxes, screens, marginal glosses, and pull 
quotes where appropriate? (p. 272) 

Designing Online Documents 

Did you 

□ create informative headers and footers? (p. 282) 

EE help readers navigate the site by including a site map, 
a table of contents, "Back to top" links, and textual 
navigation buttons? (p.283) 

EE include extra features your readers might need, such as 
an FAQ page, a search page or engine, resource links, a 
printable version of your site, or a text-only version? 

(p. 285) 

' help readers connect with others through links to 
interactive portions of your site and to social-media 
sites? (p. 285) 

I design for readers with vision, hearing, or mobility 

impairment? (p. 285) 

I design for multicultural audiences? (p. 286) 

□ aim for simplicity in web page design by using simple 
backgrounds and conservative color combinations and 
by avoiding decorative graphics? (p. 287) 

EH make the text easy to read and understand by keeping it 
short, chunking information, and writing simply? (p. 288) 

□ create clear, informative links? (p. 288 ) 


EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1. Study the first and second pages of an article in a 
journal in your field. Describe ten design features 
on these two pages. Which design features are most 
effective for the audience and purpose? Which are least 
effective? 


2. TEAM EXERCISE Form small groups for this 

collaborative exercise in analyzing design. Photocopy or 
scan a page from a book or a magazine. Choose a page 
that does not contain advertisements. Each person 
works independently for the first part of this project: 

• One person describes the design elements. 
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• One person evaluates the design. Which aspects 
of the design are effective, and which could be 
improved? 

• One person creates a new design using thumbnail 
sketches. 

Then meet as a group and compare notes. Do all 
members of the group agree with the first member's 
description of the design? With the second member's 
evaluation of the design? Do all members like the third 
member's redesign? What have your discussions taught 


you about design? Write a memo to your instructor 
presenting your findings, and include the photocopy or 
scan of the page with your memo. 

3. Study the excerpt from this Micron data flyer (201 2, 
p. 1). Describe the designer's use of alignment 
as a design principle. How effective is it? How 
would you modify it? Present your analysis 
and recommendations in a brief memo to your 
instructor. 


CSN33: Micron BGA Manufacturer’s User Guide 

Introduction 


Customer Service Note 

BGA Manufacturer’s User Guide for Micron BGA Parts 


Introduction 

This customer service note provides information that will enable customers to easily 
integrate both leading-edge and legacy Micron® ball grid array (BGA) packages into 
their manufacturing processes. It is intended as a set of high-level guidelines and a refer- 
ence manual describing typical package-related and manufacturing process-flow prac- 
tices. The recommendations and suggestions provided in this customer service note 
serve as a guideline to help the end user to develop user-specific solutions. It is the 
responsibility of the end user to optimize the process to obtain the desired results. 

Because the package landscape changes rapidly and information can become outdated 
very quickly, refer to the latest product specifications. Contact your sales representative 
for any additional questions not covered within this guide. 

An overview of a typical BGA package and its components are shown in Figure 1. 

Figure 1: Ball Grid Array Package (Dual Die, Wire Bonded) 

Silicon die Wire bond (typically gold) 


Die attach layer or 
flip chip with 
solder bumps 


Solder ball 

JEDEC Terminology 

This document uses JEDEC terminology. JEDEC-based BGA devices in the semicon- 
ductor industry are identified by two key attributes: 

• Maximum package height (profile) 

• Ball pitch 

For example: TFBGA - 1.2mm package height and less than 1.0mm ball pitch. 

Package descriptors FI through F6 have been added to provide more detailed ball pitch 
information for devices with a ball pitch of less than 0.8mm. Within the industry, many 
memory manufacturers continue to use only the “F” descriptor for any ball pitch of 
1.0mm or less (see JEDEC JESD30E for additional information). Maximum package 
height profile and ball pitch codes based on the JEDEC standard are shown in Tables 1 


1 1097 ^ geOlUWtaOTTechn^w. I™- Al rights reserved 

Products and specifications discussed herein are for evaluation and reference purposes only and are subject to change by 
Micron without notice. Products are only warranted by Micron to meet Micron’s production data sheet specifications. All 
information discussed herein is provided on an “as is” basis, without warranties of any kind. 


PDF: 09005aef8479301VSource: 09005aef84792f7e 
csn33_bga_user_gukle.fmnev. A 12/12 EN1 



Mold compound 


PCB substrate 


j^icron 


Document: Copyright © Micron Technology, Inc. All rights reserved. Reprinted by permission. 
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4. Find the websites of three manufacturers within a single 
industry, such as personal watercraft, cars, computers, 
or medical equipment. Study the three sites, focusing 
on one of these aspects of site design: 

• use of color 

• quality of the writing 

• quality of the site map or index 

• navigation, including the clarity and placement of 
links to other pages in the site 

• accommodation of multicultural readers 


• accommodation of people with disabilities 

• phrasing of the links 

Which of the three sites is most effective? Which is least 
effective? Why? Compare and contrast the three sites in 
terms of their effectiveness. 

5. Using a search engine, find a website that serves the 
needs of people with a physical disability (for example, 
the Glaucoma Foundation, www.glaucomafoundation 
.org). What attempts have the designers made to 
accommodate the needs of visitors to the site? Flow 
effective do you think those attempts have been? 


CASE 1 1 : Designing a Flyer 


As an employee in the educational information office in the U.S. Department of Education, 
you have been asked by your supervisor to design a flyer for international students 
hoping to complete graduate school in the United States. She's given you a text document 
with all of the relevant information; it's your job to turn that information into a visually 
appealing flyer that will catch students' attention. Your supervisor has asked you to write 
her a memo before you begin, describing and defending the design you have in mind. 

To get started designing your flyer, go to "Cases" under "Additional Resources" in Ch. 11: 
macmillanhighered.com/launchpad/techcomm1 1 e. 
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GRAPHICS ARE THE "PICTURES" in technical communication: drawings, maps, 
photographs, diagrams, charts, graphs, and tables. Graphics range from realistic, 
such as photographs, to highly abstract, such as organization charts. They range 
from decorative, such as clip art and stock photos that show people seated at 
a conference table, to highly informative, such as a schematic diagram of an 
electronic device. 

Graphics are important in technical communication because they do the 
following: 

• catch readers' attention and interest 

• help writers communicate information that is difficult to communicate with words 

• help writers clarify and emphasize information 

• help nonnative speakers of English understand information 

• help writers communicate information to multiple audiences with different 
interests, aptitudes, and reading habits 


The Functions of Graphics 

We have known for decades that graphics motivate people to study docu- 
ments more closely. Some 83 percent of what we learn derives from what we 
see, whereas only 11 percent derives from what we hear (Gatlin, 1988). Because 
we are good at acquiring information through sight, a document that includes 
a visual element in addition to the words is more effective than one that 
doesn’t. People studying a document with graphics learn about one-third more 
than people studying a document without graphics (Levie & Lentz, 1982). And 
people remember 43 percent more when a document includes graphics 
(Morrison & Jimmerson, 1989). In addition, readers like graphics. According 
to one survey, readers of computer documentation consistently want more 
graphics and fewer words (Brockmann, 1990, p. 203). 
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Graphics offer five benefits that words alone cannot: 

• Graphics are indispensable in demonstrating logical and numerical 
relationships. For example, an organization chart effectively represents 
the lines of authority in an organization. And if you want to communicate 
the number of power plants built in each of the last 10 years, a bar graph 
works better than a paragraph. 

• Graphics can communicate spatial information more effectively than words 
alone. If you want to show the details of a bicycle derailleur, a diagram of 
the bicycle with a close-up of the derailleur is more effective than a verbal 
description. 

• Graphics can communicate steps in a process more effectively than words 
alone. A troubleshooter’s guide, a common kind of table, explains what 
might be causing a problem in a process and how you might fix it. And a 
diagram can show clearly how acid rain forms. 

• Graphics can save space. Consider the following paragraph: 

In the Wilmington area, some 80 percent of the population aged 18 to 24 have 
watched streamed movies on their computers. They watch an average of 1.86 movies 
a week. Among 25- to 34-year-olds, the percentage is 72, and the average number 
of movies is 1 .62. Among 35- to 49-year-olds, the percentage is 62, and the average 
number of movies is 1 .1 9. Among the 50 to 64 age group, the percentage is 47, and 
the number of movies watched averages 0.50. Finally, among those people 65 years 
old or older, the percentage is 28, and the average number of movies watched weekly 
is 0.31. 

Presenting this information in a paragraph is uneconomical and makes 
the information hard to remember. Presented as a table, however, the 
information is more concise and more memorable. 


AGE 

PERCENTAGE WATCHING 
STREAMING MOVIES 

NUMBER OF MOVIES 
WATCHED PER WEEK 

18-24 

80 

1.86 

25-34 

72 

1.62 

35-49 

62 

1.19 

50-64 

47 

0.50 

65+ 

28 

0.31 


• Graphics can reduce the cost of documents intended for international 
readers. Translation costs more than 10 cents per word (ProZ.com, 2013). 
Used effectively, graphics can reduce the number of words you have to 
translate. 

As you plan and draft your document, look for opportunities to use graph- 
ics to clarify, emphasize, summarize, and organize information. 
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The Characteristics of an Effective Graphic 

To be effective, graphics must be clear, understandable, and meaningfully 

related to the larger discussion. Follow these five principles: 

• A graphic should serve a purpose. Don’t include a graphic unless it will 
help readers understand or remember information. Avoid content-free 
photographs and clip art, such as drawings of businesspeople shaking hands. 

• A graphic should be simple and uncluttered. Three-dimensional bar graphs 
are easy to make, but they are harder to understand than two-dimensional 
ones, as shown in Figure 12.1. 

• A graphic should present a manageable amount of information. Presenting 
too much information can confuse readers. Consider audience and purpose: 
what kinds of graphics are your readers familiar with, how much do they 
already know about the subject, and what do you want the document to 
do? Because readers learn best if you present information in small chunks, 
create several simple graphics rather than a single complicated one. 

• A graphic should meet readers' format expectations. Through experience, 
readers learn how to read different kinds of graphics. Follow the 
conventions — for instance, use diamonds to represent decision points in a 
flowchart — unless you have a good reason not to. 

• A graphic should be clearly labeled. Give every graphic (except a brief, 
informal one) a unique, clear, informative title. Fully label the columns of a 
table and the axes and lines of a graph. Don’t make readers guess whether 
you are using meters or yards, or whether you are also including statistics 
from the previous year. 
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984 
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Uninsured 


Unnecessary 3D is one example 
of chartjunk, a term used byTufte 
(1 983) to describe the ornamenta- 
tion that clutters up a graphic, dis- 
tracting readers from the message. 

The two-dimensional bar graph 
is clean and uncluttered; the 
three-dimensional graph is more 
difficult to understand because the 
additional dimension obscures the 
main data points. The number of 
uninsured emergency-room visits in 
February, for example, is very diffi- 
cult to see in the three-dimensional 
graph. 


FIGURE 12.1 Chartjunk and Clear Art 
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CREATING HONEST GRAPHICS 

Follow these six suggestions to ensure that you represent data honestly in your graphics. 


• If you did not create the graphic or generate the data, cite your source. If you want to publish a 
graphic that you did not create, obtain permission. For more on citing graphics, see page 302. 

• Include all relevant data. For example, if you have a data point that you cannot explain, do 
not change the scale to eliminate it. 

• Begin the axes in your graphs at zero — or mark them clearly — so that you represent quanti- 
ties honestly. 

• Do not use a table to hide a data point that would be obvious in a graph. 

• Show items as they really are. Do not manipulate a photograph of a computer monitor to 
make the screen look bigger than it is, for example. 

• Do not use color or shading to misrepresent an item's importance. A light-shaded bar in a 
bar graph, for example, appears larger and nearer than a dark-shaded bar of the same size. 

Common problem areas are pointed out in the discussions of various kinds of graphics 

throughout this chapter. 


It is not enough to add graphics to your text; you have to integrate the two. 

► Place the graphic in an appropriate location. If readers need the graphic in order 
to understand the discussion, put it directly after the relevant point in the discus- 
sion or as soon after it as possible. If the graphic merely supports or elaborates a 
point, include it as an appendix. 

► Introduce the graphic in the text. Whenever possible, refer to a graphic before 
it appears (ideally, on the same page). Refer to the graphic by number (such as 
"see Figure 7"). Do not refer to "the figure above" or "the figure below," because 
the graphic might move during the production process. If the graphic is in an ap- 
pendix, cross-reference it; "For complete details of the operating characteristics, 
see Appendix B, page 19." 

► Explain the graphic in the text. State what you want readers to learn from it. 
Sometimes a simple paraphrase of the title is enough: "Figure 2 compares the 
costs of the three major types of coal gasification plants." At other times, however, 
you might need to explain why the graphic is important or how to interpret it. If 
the graphic is intended to make a point, be explicit: 

As Figure 2 shows, a high-sulfur bituminous coal gasification plant is more 
expensive than either a low-sulfur bituminous or an anthracite plant, but 
more than half of its cost is for cleanup equipment. If these expenses could 
be eliminated, high-sulfur bituminous would be the least expensive of the 
three types of plants. 


A 



Integrating Graphics and Text 


(■ continued ) 
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In addition to text explanations, graphics are often accompanied by captions, 
ranging from a sentence to several paragraphs. 

► Make the graphic clearly visible. Distinguish the graphic from the surrounding 
text by adding white space around it, placing rules (lines) above and below it, 
putting a screen behind it, or enclosing it in a box. 

► Make the graphic accessible. If the document is more than a few pages long and 
contains more than four or five graphics, consider including a list of illustrations 
so that readers can find them easily. 


For more about white space, screens, 
boxes, and rules, see Ch. 1 1, pp. 263 
and 273. For more about lists of 
illustrations, see Ch. 18, p. 481. 


Understanding the 
Process of Creating Graphics 

Creating graphics involves planning, producing, revising, and citing. 

PLANNING GRAPHICS 

Whether you focus first on the text or the graphics, consider the following 

four issues as you plan your graphics. 

• Audience. Will readers understand the kinds of graphics you want to 
use? Will they know the standard icons in your field? Are they motivated 
to read your document, or do you need to enliven the text — for example, 
by adding color for emphasis — to hold their attention? General 
audiences know how to read common types of graphics, such as those 
that appear frequently in newspapers or on popular websites. A general 
audience, for example, could use this bar graph to compare two bottles 
of wine: 
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However, they would probably have trouble with the following radar graph: 



• Purpose. What point are you trying to make with the graphic? Imagine 
what you want your readers to know and do with the information. For 
example, if you want readers to know the exact dollar amounts spent on 
athletics by a college, use a table: 


YEAR 

MEN'S ATHLETICS ($) 

WOMEN'S ATHLETICS ($) 

2013 

38,990 

29,305 

2014 

42,400 

30,080 

2015 

44,567 

44,213 


If you want readers to know how spending on athletics is changing over 
time, use a line graph: 



The kind of information you want to communicate. Your subject will help 
you decide what type of graphic to include. For example, in writing about 
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languages spoken by your state’s citizens, you might use a table for the 
statistical data, a map for the patterns of language use, and a graph for 
statistical trends over time. 

• Physical conditions. The physical conditions in which readers will use 
the document — amount of lighting, amount of surface space available, 
the size of the screen on which the information will be displayed, and so 
forth — will influence the type of graphic as well as its size and shape, the 
thickness of lines, the size of type, and the color. 

As you plan how you are going to create the graphics, consider four impor- 
tant factors: 

• Time. Because making a complicated graphic can take a lot of time, you 
need to establish a schedule. 

• Money. Creating a high-quality graphic can be expensive. How big is the 
project budget? How can you use that money effectively? 

• Equipment. Determine what tools and software you will require, such as 
spreadsheets for tables and graphs or graphics software for diagrams. 

• Expertise. How much do you know about creating graphics? Do you have 
access to the expertise of others? 

PRODUCING GRAPHICS 

Usually, you won’t have all the resources you would like. You will have to 

choose one of the following four approaches: 

• Use existing graphics. For a student paper that will not be published, some 
instructors allow the use of photocopies or scans of existing graphics; 
other instructors do not. For a document that will be published, whether 
written by a student or a professional, using an existing graphic is 
permissible if the graphic is in the public domain (that is, not under 
copyright), if it is the property of the writer’s organization, or if the 
organization has obtained permission to use it. Be particularly careful 
about graphics you find on the web. Many people mistakenly think that 
anything on the web can be used without permission. The same copyright 
laws that apply to printed material apply to web-based material, whether 
words or graphics. For more on citing graphics, see page 302. 

Aside from the issue of copyright, think carefully before you use existing 
graphics. The style of the graphic might not match that of the others you 
want to use; the graphic might lack some features you want or include some 
you don’t. If you use an existing graphic, assign it your own number and title. 

• Modify existing graphics. You can redraw an existing graphic or use a 
scanner to digitize the graphic and then modify it electronically with 
graphics software. 

• Create graphics on a computer. You can create many kinds of graphics 
using your spreadsheet software and the drawing tools on your word 


For more about planning and 
budgeting, see Ch. 3, p. 47. 
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>TECH TIP 


HowTo Insert and Modify Graphics 

To highlight, clarify, summarize, and organize information, 
you can insert and modify graphics by using the Picture but- 
ton and the Format 
tab. 


To insert a graphic 

that you have on 
file — such as a photo- 
graph, drawing, chart, 
or graph — place your cursor where you want to insert the 
graphic and then select the Picture button in the Illustra- 
tions group on the Insert tab. 



You can also insert clip art, shapes, charts, screenshots, and 
Smart Art. 


To modify an image that is already in your document, 
double-click on it and then use the Picture Tools Format tab. 
This tab allows you to modify the appearance, size, and layout 
of a picture. 



Buttons in the Adjust group allow you to modify many as- 
pects of the picture's appearance. 

Buttons in the Arrange group allow you to position your 
graphic and control how text wraps around it. 


KEYWORDS: format tab, arrange group, picture style, size, ad- 
just, insert picture, format picture, modify picture, picture style, 
picture toolbar 



processor. Consult the Selected Bibliography, page 693, for a list of books 
about computers and technical communication. 

For more about work made for hire, • Have someone else create the graphics. Professional-level graphics 

see Ch. 2, p. 24. software can cost hundreds of dollars and require hundreds of hours of 

practice. Some companies have technical-publications departments with 
graphics experts, but others subcontract this work. Many print shops and 
service bureaus have graphics experts on staff or can direct you to them. 

REVISING GRAPHICS 

As with any other aspect of technical communication, build in enough time 
and budget enough money to revise the graphics you want to use. Create a 
checklist and evaluate each graphic for effectiveness. The Writer’s Checklist 
at the end of this chapter is a good starting point. Show your graphics to 
people whose backgrounds are similar to those of your intended readers and 
ask them for suggestions. Revise the graphics and solicit more reactions. 

CITING SOURCES OF GRAPHICS 

For more information about If you wish to publish a graphic that is protected by copyright (even if you 

copyright, seeCh. 2, p. 24. have revised it), you need to obtain written permission from the copyright 

holder. Related to the issue of permission is the issue of citation. Of course, 
you do not have to cite the source of a graphic if you created it yourself, if it 
is not protected by copyright, or if your organization owns the copyright. 

In all other cases, however, you should include a source citation, even if 
your document is a course assignment and will not be published. Citing the 
sources of graphics, even those you have revised substantially, shows your 
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instructor that you understand professional conventions and your ethical 
responsibilities. 

If you are following a style manual, check to see whether it presents a for- 
mat for citing sources of graphics. In addition to citing a graphic’s source in the 
reference list, most style manuals call for a source statement in the caption: 

PRINT SOURCE 

Source: Verduijn, 201 5, p. 14. Copyright 201 5 byTedopres International B.V. Reprinted 

with permission. 

ONLINE SOURCE 

Source: Johnson Space Center Digital Image Collection. Copyright 201 5 by NASA. 

Reprinted with permission. 

If your graphic is based on an existing graphic, the source statement 
should state that your graphic is “based on” or “adapted from” your source: 

Source: Adapted from Jonklaas et at, 201 1, p. 771 . Copyright 2008 by American 

Medical Association. Reprinted with permission. 


Using Color Effectively 

Color draws attention to information you want to emphasize, establishes 
visual patterns to promote understanding, and adds interest. But it is also 
easy to misuse. The following discussion is based on Jan V. White’s excellent 
text Color for the Electronic Age (1990). 

In using color in graphics and page design, keep these six principles in mind: 

• Don't overdo it. Readers can interpret only two or three colors at a 
time. Use colors for small items, such as portions of graphics and 
important words. And don’t use colors where black and white will work 
better. 

• Use color to emphasize particular items. People interpret color before they 
interpret shape, size, or placement on the page. Color effectively draws 
readers’ attention to a particular item or group of items on a page. In 
Figure 12.2 (on page 304), for example, color adds emphasis to different 
kinds of information. 

• Use color to create patterns. The principle of repetition — readers learn to 
recognize patterns — applies in graphics as well as in document design. 

In creating patterns, also consider shape. For instance, use red for safety 
comments but place them in octagons resembling a stop sign. This way, 
you give your readers two visual cues to help them recognize the pattern. 
Figure 12.3 (on page 304) shows the use of color to establish patterns. Color 
is also an effective way to emphasize design features such as text boxes, 
rules, screens, and headers and footers. 

• Use contrast effectively. The visibility of a color is a function of the 
background against which it appears (see Figure 12.4). The strongest 
contrasts are between black and white and between black and yellow. The 


For more about style manuals, see 
Appendix, Part B, p. 614. 


For more about designing your 
document, see Ch. 1 1. 


For more about presentation 
graphics, see Ch. 2 1, p. 582. 
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For more about cultural patterns, see 
Ch. 5, p. 95. 


Additional post-retirement 
contributions - future 
contributions 

As of Sept. 30 - thousands of dollars 


2010 

$ 33,435 

2011 

33,560 

2012 

34,486 

2013 

35,641 

2014 

37,002 

i 

$174,124 


Source: Bonneville, 2009: www.bpa.gov/Financial 
Information/Annual reports/Documents 
MR2009.pdf 


Color used to empha- 
size one item among 
others. 


Color used to set off 
a title and the totals 
row in a table. 

Red Algae 

Almost all red algae 
are multicellular (Figure 
28.24). Some plant biolo- 
gists now refer to the red 
algae as the "red plant king- 
dom." Their characteristic color is 
a result of the accessory photosyn- 
thetic pigment phycoerythrin, which 
is found in relatively large amounts 
in the chloroplasts of many species. In 
addition to phycoerythrin, red algae 
contain phycocyanin, carotenoids, and chlorophyll a. 

Source: From W. K. Purves, D. Sadava, G. H. Orians, and H. C. Heller, 
LIFE: THE SCIENCE OF BIOLOGY, Seventh Edition, Page 560. Copy- 
right ©2004. Reprinted by permission of Sinauer Associates, Inc. 



FIGURE 12.2 Color Used for Emphasis 


need for effective contrast also applies to graphics used in presentations, 
as shown in Figure 12.5. 

• Take advantage of any symbolic meanings colors may already have. 

In American culture, for example, red signals danger, heat, or 
electricity; yellow signals caution; and orange signals warning. Using 
these warm colors in ways that depart from these familiar meanings 
could be confusing. The cooler colors — blues and greens — are more 
conservative and subtle. (Figure 12.6 illustrates these principles.) Keep 
in mind, however, that people in different cultures interpret colors 
differently. 



Human 



■ Pyloric sphincter 
Pybrus 

■ Corpus or fundus 

■ Esophagus 
Forestomach or rumen 


Mouse 



FIGURE 12.3 Color Used to Establish Patterns 
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FIGURE 12.4 The Effect of Background in Creating Contrast 


Notice that a color washes out if the 
background color is too similar. 



a. Insufficient contrast b. Effective contrast 

FIGURE 1 2.5 Effective Contrast Used in a Presentation Slide 


In graphic (a), the text is hard to 
read because of insufficient con- 
trast. The greater contrast in graphic 
(b) makes the text easier to read. 



FIGURE 12.6 Colors Have Clear Associations for Readers 


Inductive 

charging 

system 


Variable- 
temperature seat 

Audio navigation 
system 

Battery pack 


Brushless 
DC motor 


Battery 

monitor 


system 


Saf f ty Motor Ener 9V 
SyStem controller management 
system 

Regenerative 
braking 
system 


The batteries are red. The warm red 
contrasts effectively with the cool 
green of the car body. 
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If you are using print against a 
colored background, you might 
need to make the type a little big- 
ger, because color makes text look 
smaller. 

Text printed against a white 
background looks bigger than the 
same-size text printed against a 
colored background. White letters 
counteract this effect. 


• Be aware that color can obscure or swallow up text. 


Is this text 

Is this text 

the same size? 

the same size? 


This line of type appears to reach out to the reader. 


This line of type appears to recede into the background. 


Choosing the Appropriate Kind of Graphic 

As Figure 12.7 shows, even a few simple facts can yield a number of differ- 
ent points. Your responsibility when creating a graphic is to determine what 
point you want to make and how best to make it. Don’t rely on your software 
to do your thinking; it can’t. 

Graphics used in technical documents are classified as tables or figures. 
Tables are lists of data, usually numbers, arranged in columns. Figures are 
everything else: graphs, charts, diagrams, photographs, and the like. Typically, 
tables and figures are numbered separately: the first table in a document is 
Table 1; the first figure is Figure 1. In documents of more than one chapter 
(like this book), the graphics are usually numbered within each chapter. That 
is, Figure 3.2 is the second figure in Chapter 3. 

The discussion that follows is based on the classification system in 
William Horton’s “Pictures Please — Presenting Information Visually,” in 
Techniques for Technical Communicators (Horton, 1992). Table 12.1 on page 308 
presents an overview of the following discussion. 

ILLUSTRATING NUMERICAL INFORMATION 

The kinds of graphics used most often to display numerical values are tables, 
bar graphs, infographics, line graphs, and pie charts. 

Tables Tables convey large amounts of numerical data easily, and they are 
often the only way to present several variables for a number of items. For 
example, if you wanted to show how many people are employed in six indus- 
tries in 10 states, a table would probably be most effective. Although tables 
lack the visual appeal of other kinds of graphics, they can handle much more 
information. 

In addition to having a number (“Table 1”), tables are identified by an infor- 
mative title that includes the items being compared and the basis (or bases) 
of comparison: 

Table 3. Mallard Population in Rangeley, 2009-201 1 

Table 4.7. The Growth of the Robotics Industry in Japan and the United States, 2010 
Figure 12.8 (on page 310) illustrates the standard parts of a table. 
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Rail Line 

November 

December 

January 

Disabled by 
electrical problems (%) 

Total 

disabled 

Disabled by 
electrical problems (%) 

Total 

disabled 

Disabled by 
electrical problems (%) 

Total 

disabled 

Bryn Mawr 

19(70) 

27 

17(60) 

28 

20 (76) 

26 

Swarthmore 

12(75) 

16 

9(52) 

17 

13(81) 

16 

Manayunk 

22 (64) 

34 

26 (83) 

31 

24 (72) 

33 



a. Number of railcars disabled, 
November-January 



c. Number of railcars disabled by 

electrical problems, November-January 



Bryn Mawr Manayunk Swarthmore 


d. Range in percentage of railcars, by line, disabled 
by electrical problems, November-January 


FIGURE 1 2.7 Different Graphics Emphasizing Different Points 

Each of these four graphs emphasizes a different point derived from the data in the table. Graph (a) focuses on the total 
number of railcars disabled each month, classified by cause; graph (b) focuses on the three rail lines during one month; 
and so forth. For information on bar graphs, see pages 312-1 7; for information on line graphs, see pages 3 1 9-22. 
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TABLE 12.1 Choosing the Appropriate Kind of Graphic 


PURPOSE TYPE OF GRAPHIC WHAT THE GRAPHIC DOES BEST 


Illustrating numerical Table 
information 


East 

West 

South 

Total 


Jan Feb Mar Total 
14 14 10 38 
12 8 14 34 

9 15 18 42 
35 37 42 114 


Shows large amounts of numerical data, 
especially when there are several variables 
for a number of items 


Bar graph 


Shows the relative values of two or more 
items. 


Infographic 



Enlivens statistical information for the 
general reader. 


Source: Whitehouse.gov, 2014: 

http://www.whitehouse.gov 

/share/current-minimum 

-wage-isn-t-enough-workers 

-get-outpoverty. 


Line graph 


Shows how the quantity of an item 
changes over time. A line graph can 
present much more data than a bar graph 
can. 


Pie chart 



Shows the relative sizes of the parts of a 
whole. Pie charts are instantly familiar to 
most readers. 


Illustrating logical Diagram 

relationships 


Dimmer/ 

Switch/Fan-Speed 

Control 


Host Black 


120 VAC 
60Hz 



Lighting 
Load of Fan 


Represents relationships among items or 
properties of items. 


Neutral 


Organization chart 


Block-Diagram Version 


120 ADM 

Protocol Control 


TCG 

Module 


TCG 

Module 


Shows the lines of authority and 
responsibility in an organization or 
hierarchical relationships among items. 


Illustrating process Checklist 

descriptions and 

instructions 



Lists or shows what equipment or 
materials to gather or describes an action. 


(■ continued ) 
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TABLE 12.1 Choosing the Appropriate Kind of Graphic (continued) 


PURPOSE TYPE OF GRAPHIC WHAT THE GRAPHIC DOES BEST 


Illustrating process Table 

descriptions 
and instructions 
(■ continued ) 



Shows numbers of items or indicates the 
state (on/off) of an item. 


Flowchart 


Shows the stages of a procedure or a 
process. 



Logic tree 



Shows which of two or more paths to 
follow. 


Illustrating visual and Photograph 
spatial characteristics 



Shows precisely the external surface of 
objects. 



Shows what appears on a computer 
screen. 


Linedrawinq /H 

<8 ; ii -a 


Shows simplified representations of 
objects. 



Based on W. Horton, "The Almost Universal Language: Graphics for international Documentation" from TECHNICAL COMMUNICATION 40 (1993): 682-693. 
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Tables are usually titled at the top 
because readers scan them from 
top to bottom. 


Natural Gas Plant Stocks 

(Thousand Barrels) 


The data in this table consist of numbers, but tables 
can also present textual information or a combination 
of numbers and text. 


Some tables include a stub head. 
The stub — the left-hand column — 
lists the items for which data are 
displayed. Note that indentation in 
the stub helps show relationships. 
The heading "Natural Gas Liquids" 
is left-aligned. This row functions 
as a Totals row. Indented beneath 
this heading are the two categories 
that make up the totals: pentanes 
plus and liquefied petroleum gases. 
Beneath the heading are rows for 
the four kinds of liquefied petro- 
leum gases. 


Note that the numbers are right- 
aligned. 


Note that tables often contain one 
or more source statements and 
footnotes. 


Area: U.S. 


Period: 

Monthly 







|2&] Download Series History Q Definitions. Sources & Notes 1 

Show Data By: 

<? Product O Area 

| Graph ~| 

1°- J 

Nov-12 

Dec-12 

Jan-13 

Feb-13 

Mar-13 

Apr-13 

View 

History 

Natural Gas Liquids 

□ 

5.047 

4.828 

4.550 

4.787 

5.625 

5.419 

imim 

Pentanes Plus 

ny\ 

^ ! 

492 

383 

462 

553 

67s[ 

787 

1993-2013 

Liquefied Petroleum Gases 

yt\ 

4,555 

4.445 

4.088 

4.234 

4.950 

4.632 

1993-2013 

Ethane 

n 

672 

837 

871 

812 

1.212 

822 

1993-2013 

Propane 

B 

1.998 

1.944 

1.655 

1,702 

2.126 

2.098 

1993-2013 

Normal Butane 

□ 

1,207 

907 

864 

830 

757 

936 

1993-2013 

Isobutane 

□ 

678 

757 

698 

890 

855 

776 

1893:2013 


- « No Cato Reported; - * Not Applicable; HA » Not Available. W « Withheld to avoid disclosure of individual company data 
Nates: See Definitions. Sources, and Notes fink above for more information on this table. 

Release Date; 6/27/2013 

Next Release Date: Last Week of July 2013 


FIGURE 12.8 Parts of a Table 

This is an interactive table from the Energy Information Administration showing the amount of 
natural gas stocks in the United States over a six-month period. Note that you can use the radio 
buttons to show the data by location or product, and you can use the pull-down menu to specify 
a time frame. Even though this table is interactive, it functions much the way any table does. 
Source: U.S. Energy Information Administration, 201 3: www.eia.gov/dnav/pet/pet_stoc_gp_dcu_nus_m.htm. 
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Creating Effective Tables 


Follow these nine suggestions to make sure your tables are clear and professional. 


► Indicate the units of measure. If all the data are expressed in the same unit, 
indicate that unit in the title: 


Farm Size in the Midwestern States (in Hectares) 

If the data in different columns are expressed in different units, indicate the units 
in the column heads: 


Population 
(in Millions) 

Per Capita Income 

(in Thousands of U.S. Dollars) 




If all the data cells in a column use the same unit, indicate that unit in the column 
head, not in each data cell: 

Speed (in Knots) 

15 

18 

14 


(■ continued ) 
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You can express data in both real numbers and percentages. A column head and 
the first data cell under it might read as follows: 

Number of Students (Percentage) 

53 (83) 

► In the stub — the left-hand column — list the items being compared. Arrange the 
items in a logical order: big to small, more important to less important, alphabeti- 
cal, chronological, geographical, and so forth. If the items fall into several catego- 
ries, include the names of the categories in the stub: 

Snowbelt States 

Connecticut 

New York 

Vermont 

Sunbelt States 

Arizona 

California 

New Mexico 

For more about screens, see Ch. 1 1, 
p. 274. 


► In the columns, arrange the data clearly and logically. Use the decimal-tab fea- 
ture to line up the decimal points: 

3.147.4 
365.7 

46,803.5 

In general, don't vary the units used in a column unless the quantities are so 
dissimilar that your readers would have a difficult time understanding them if 
expressed in the same units. 

3.4 hr 
12.7 min 

4.3 sec 

This list would probably be easier for most readers to understand than one in 
which all quantities were expressed in the same unit. 

► Do the math. If your readers will need to know the totals for the columns or the 
rows, provide them. If your readers will need to know percentage changes from 
one column to the next, present them: 

Number of Students (Percentage Change from Previous Year) 

2013 2014 2015 

619 644 (+4.0) 614 (-4.7) 

► Use dot leaders if a column contains a "blank" spot — a place where there are no 
appropriate data: 

3,147 

46,803 

But don't substitute dot leaders for a quantity of zero. 


If you cannot group the items in the stub in logical categories, skip a line after ev- 
ery five rows to help the reader follow the rows across the table. Or use a screen 
(a colored background) for every other set of five rows. Also useful is linking the 
stub and the next column with a row of dots called dot leaders. 


( continued ) 
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► Don't make the table wider than it needs to be. The reader should be able to 
scan across a row easily. As White (1 984) points out, there is no reason to make 
a table as wide as the text column in the document. If a column head is long — 
more than five or six words — stack the words: 

Computers Sold Without 
a Memory-Card Reader 

► Minimize the use of rules. Grimstead (1 987) recommends using rules only when 
necessary: to separate the title and the heads, the heads and the body, and the 
body and the notes. When you use rules, make them thin rather than thick. 

► Provide footnotes where necessary. All the information your readers need in 
order to understand the table should accompany it. 

► If you did not generate the information yourself, indicate your source. See the 

discussion of citing sources of graphics on pages 302-03. 


Bar Graphs Like tables, bar graphs can communicate numerical values, but 
they are better at showing the relative values of two or more items. Figure 
12.9 shows typical horizontal and vertical bar graphs that you can make 
easily using your spreadsheet software. Figure 12.10 shows an effective bar 
graph that uses grid lines. 


Horizontal bars are best for show- 
ing quantities such as speed and 
distance. Vertical bars are best for 
showing quantities such as height, 
size, and amount. However, these 
distinctions are not ironclad; as 
long as the axes are clearly labeled, 
readers should have no trouble 
understanding the graph. 


Items 


A 




B 




C 




D 


E 

1 1 1 1 1 1 1 


Quantity 

Figure 1. Horizontal graph 


Quantity 


A B C D E 
Items 

Figure 1 . Vertical graph 


FIGURE 1 2.9 Structures of Horizontal and Vertical Bar Graphs 
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Inflation Rate 
(in percent) 

7 


J F M A M 

Figure 1 . Tri-County Inflation Rate This Year to Date 


FIGURE 12.10 Effective Bar 
Graph with Grid Lines 


>TECH TIP 


HowTo Use Tab Stops 


The following table describes common tab stops. 


To control the placement of text on a page or in a table, you 
can align text by using the tab stops in the horizontal ruler. 
Select the Ruler checkbox in the Show group on the View 
tab to see the ruler. 

For example, use the decimal tab to align numbers in a 
column: 


Incorrectly Aligned 
213.76 
3.17 
46.13 


Correctly Aligned 
213.76 
3.17 
46.13 


1 . Click the tab indicator on the horizontal ruler to change 



Tab stop 

Description 

H 

Lines up text to the left 

0] 

Lines up text to the right 

H 

Centers text at tab stop 

0] 

Aligns numbers on their decimal points 



2. When the appropriate tab stop appears, click the hori- 
zontal ruler where you want to align text. 


To remove a tab stop, drag it away from the ruler. 

3. After you have set a tab stop, place the cursor to the left 
of the text you want to align and press the Tab key. 


KEYWORDS: set tab stops, horizontal ruler, indent text or num- 
bers in a table 
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>TECH TIP 


HowTo Create Tables 



To create tables, use the Table 
feature. 

To create a table, place your cursor 
where you want the table, and then 
click the Table button on the Insert 
tab. 


You can create a table by drag- 
ging your cursor to specify the 
number of columns and rows. 

You can also create a table by 
drawing the table grid, convert- 
ing existing text into a table, 
importing data from Excel, or se- 
lecting a QuickTables template - 
and replacing the data with your ( 


t Imert Page layout Refer* 

Table | 

@ sa cp 2 ; 

Picture Clip Shapes _ 
Ait * 


BBB! 


EBB! 


□□□□□□□ 
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□□□□□□□ 
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□□□□□□□□□□ 
□□□□□□□□□□ 
0 insert Table... 

Qraw Table 
Concert Teit to Table. 

E«cei Spreadsheet 
0 Quick Jables 



KEYWORDS: tables, tables and borders, insert table, insert tab, 
table styles 


>TECH TIP 


HowTo Create Graphics in Excel 


You can create many types of graphics discussed in this chap- 
ter using a spreadsheet program such as Microsoft Excel. 

First you enter the data that the graphic will display; then you 
select the type of graphic to create. 


1 . After you have entered your data in a spreadsheet, select 
the type of graphic by using the drop-down menus in 
the Charts group on the Insert tab. 


ykb 

Column 


line - Area ’ 

Pie Scatter » 

gpBar» Ij Other Charts ’ r 
Charts G 


You can also select the Chart dialog box launcher in the 
Charts group and then select the type of graphic using 
the Insert Chart dialog box. 
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2 . 



After you have created your graphic, you can modify the 
data range included and add or modify elements such 
as a title, labels, a legend, and grid lines by using the 

Design, Layout, and Format tabs. 


$ilgrao«sh«et_»io icompjo&uty Motft) • Microsoft t««r 

kvM fonrwlli »*"»• VHw 

saa jail bb 


5?SMPH • 


Cnwt Arts 

Ft*«« Stetaion 

Current Jtkcllon 


After creating a graphic, you can use the Copy and Paste 
commands to insert your graphic in your document. 


KEYWORDS: chart wizard, chart type, data series, data range, 
data labels, legends 







Choosing the Appropriate Kind of Graphic 


12 


315 


4 \ 


GUIDELINES 


Creating Effective Bar Graphs 


► Make the proportions fair. Make your vertical axis about 25 percent 

shorter than your horizontal axis. An excessively long vertical axis exaggerates 
the differences in quantities; an excessively long horizontal axis minimizes the 
differences. Make all the bars the same width, and make the space between them 
about half as wide as a bar. Here are two poorly proportioned graphs: 



a. Excessively long vertical axis b. Excessively long horizontal axis 


► If possible, begin the quantity scale at zero. Doing so ensures that the bars accu- 
rately represent the quantities. Notice how misleading a graph can be if the scale 
doesn't begin at zero. 



a. Misleading b. Accurately representative 

If it is not practical to start the quantity scale at zero, break the quantity axis 
clearly at a common point on all the bars. 



( continued ) 





316 


12 


CREATING GRAPHICS 


► Use tick marks — marks along the axis — to signal the amounts. Use grid 
lines — tick marks that extend through the bars — if the table has several bars, 
some of which are too far away from the tick marks to enable readers to gauge 
the quantities easily. (See Figure 1 2.1 0 on p. 313.) 

► Arrange the bars in a logical sequence. For a vertical bar graph, use chronology 
if possible. For a horizontal bar graph, arrange the bars in order of descending 
size, beginning at the top of the graph, unless some other logical sequence 
seems more appropriate. 

► Place the title below the figure. Unlike tables, which are usually read from top to 
bottom, figures are usually read from the bottom up. 

► Indicate the source of your information if you did not generate it yourself. 


The five variations on the basic bar graph shown in Table 12.2 can help you 
accommodate different communication needs. You can make all these types 
using your spreadsheet software. 


TABLE 12.2 Variations on the Basic Bar Graph 



Grouped bar graph. The grouped bar graph lets you compare two or three aspects for 
each item. Grouped bar graphs would be useful, for example, for showing the numbers 
of full-time and part-time students at several universities. One bar could represent 
full-time students; the other, part-time students. To distinguish between the bars, use 
hatching (striping), shading, or color, and either label one set of bars or provide a key. 



Subdivided bar graph. In the subdivided bar graph, Aspect I and Aspect II are stacked 
like wooden blocks placed on top of each. Although totals are easy to compare in a 
subdivided bar graph, individual quantities are not. 





10 20 30 40 50 60 70 80 90 100 


Quantity 



Aspect I Aspect II Aspect III 


100-percent bar graph. The 1 00-percent bar graph, which shows the relative 
proportions of the aspects that make up several items, is useful in portraying, for 
example, the proportion of full-scholarship, partial-scholarship, and no-scholarship 
students at a number of colleges. 


(■ continued ) 
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TABLE 1 2.2 Variations on the Basic Bar Graph ( continued ) 


Percent 



Time 


Deviation bar graph. The deviation bar graph shows how various quantities deviate 
from a norm. Deviation bar graphs are often used when the information contains both 
positive and negative values, such as profits and losses. Bars on the positive side of the 
norm line (above it) represent profits; bars on the negative side (below it), losses. 



Stratum graph. The stratum graph, also called an area graph, shows the change in 
quantities of several items over time. Although stratum graphs are used frequently in 
business and scientific fields, general readers sometimes have trouble understanding 
how to read them. 


Infographics An infographic — short for information graphic — is a combina- 
tion of words and graphics used to present factual data about a subject in a 
visually interesting way. 


4 \ 


GUIDELINES 


Creating Effective Infographics 


Follow these seven suggestions for making effective infographics. 


► Make a claim. A good infographic states — or at least implies — a claim and then 
presents evidence to support it. For instance, the claim might be that the number 
of people accessing the Internet in a language other than English is increasing 

at an accelerating rate, that the pace at which new drugs are coming onto the 
market is slowing, or that the cost of waging a campaign for a U.S. Senate seat 
has increased tenfold in the last twenty years. The claim you present will suggest 
the theme of your graphics: you might consider maps, flowcharts, or statistics. 

► Use accurate data. Once you have settled on your claim, find facts to support it. 
Use reputable sources, and then check and re-check them. Be sure to cite your 
sources on the infographic itself. 

► Follow the guidelines for the type of graphic you are creating. Although you 
want to express your creativity when you create graphics, abide by the guidelines 


For more about claims and support, 
seeCh. 8,p. 176. 


For more about research techniques, 
see Ch. 6. 


( continued ) 
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For more about revising, evaluating, 
and testing, seeCh. 13. 


for that type of graphic. For instance, if you use a bar graph to present data on 
the number of zebras born in captivity, your first obligation is to make the length 
of each bar reflect the quantity it represents; don't manipulate the lengths of the 
bars to make the graph look like a zebra. 

► Write concisely. If you need more than a paragraph to introduce a graphic, try 
revising the text to get the word count down or see if you can break the idea into 
several smaller ones. 

► Don't present too much information. It's natural to want to include all the data 
you have found, but if the infographic is too tightly packed with text and graph- 
ics, readers will be intimidated. Use white space to let the graphics breathe. 

► Don't go on forever. Your readers will want to spend a minute — maybe two — on 
the infographic. They won't want to spend 15 minutes. 

► Test the infographic. As with any kind of technical document, the more you 
revise, evaluate, and test the infographic, the better it will be. 


Figure 12.11, a portion of an infographic about infographics, shows many 
of the techniques used in this type of display. 

Infographics are also an effective way to communicate information through 
a visual/verbal argument. Figure 12.12 shows a portion of an infographic that 
makes a very clear argument about the rising size of food portions. 


Designer Ivan Cash created this 
infographic by collecting data about 
infographics and then creating 
graphics to make the data interest- 
ing and visually appealing. 
Infographics are built around basic 
types of graphical display: pie 
charts, line graphs, bar graphs, and 
diagrams. In an effective info- 
graphic, each visual display adheres 
to the conventions of the graphic 
on which it is based. For instance, in 
the "Countries Featured" bar graph, 
the length of each bar accurately 
reflects the quantity of the item it 
represents. 

The art makes the data visually 
interesting, but the most important 
characteristic of an infographic is 
accuracy: the data must be accurate 
and presented fairly. 



RRHCoi 




Djta vtsuUaMn n a popiMr r*» »a/ of Wmm research Here is a took at soma of the 
Hsu* deuces. nfo<mauoAai elements, and |*ne*el trends found in Uie modem day mlocrapNc 


CONTENT 


mu hue 



ftaOwt AamlCtal toOart 


fill 

VmM DCmmIhW 
■ VW 


85 % 


11(10 


".TECHNOLOGY 


BUSINESScultobe 

HEALTH 

POLITICS 


ENVIRONMENT 


mm 



A □ 




\Vk 29% 


uiiEiimnmHim 

........... 


B /x/v 1 ■ 



mu 


" RICHEST 
AND POOREST 
AMERICAN 
NEIGH 


FIGURE 12.1 1 An Infographic About Infographics 

Used by permission of Ivan Cash/Cash Studios. 
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THE NEW (AB)NORMAL 

Portion sizes have been growing So have we The average restaurant meal today is more than tour times larger 
than in Vie 1950s. And adults are, on average. 26 pounds heavier It we want to eat healthy, there are things we can 
do tor ourselves and our community Order the smaller meals on the menu, split a meal with a friend, or. eat hall 
and take the rest home We can also ask the managers at our favorite restaurants to offer smaller meals 



Many organizations use infograph- 
ics to present arguments. Here, 
the Centers for Disease Control 
compares fast-food portion sizes 
from the 1 950s and today to make 
the case that, as the text at the top 
states, "Portion sizes have been 
growing. So have we." The text goes 
on to suggest steps people can take 
to reduce their portion sizes. 

Several sites on the web, such as 
infogr.am, offer free templates for 
making infographics. 


FIGURE 12.12 

A Persuasive Infographic 

Source: Centers for Disease Control, 201 2: http://makinghealtheasier.org/newabnormal/. 


Infographics are very popular, but many of them are of low quality. Before 
you create an infographic to communicate technical information, be sure you 
are not skewing your data or oversimplifying to promote an agenda. Doing so 
is unethical. In Figure 12.13 (on page 320), digital strategist Herve Peitrequin 
offers a clever commentary on infographics. 

Line Graphs Line graphs are used almost exclusively to show changes 
in quantity over time, for example, the month-by-month production figures 
for a product. A line graph focuses readers’ attention on the change in quan- 
tity, whereas a bar graph emphasizes the quantities themselves. 

You can plot three or four lines on a line graph. If the lines intersect, use 
different colors or patterns to distinguish them. If the lines intersect too 
often, however, the graph will be unclear; in this case, draw separate graphs. 
Figure 12.14 (on page 321) shows a line graph. 
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Why I hate infographics 197% of the time: An infographic 



■ 67% - Fu 22 y math 

■ 21% - Only exists as link bait 

■ 12% - Scientifically 
inaccurate 

■ 43% - Skewed perspective 


i 9%- Biased agenda 


■ 45% - Material need not be 
presented as a dataset to 
communicate 


FIGURE 12.13 A Critique of Infographics 

Used by permission of Herve Peitrequin. 


TECH TIP 


How To Use Drawing Tools 


Although you can make many types 
of graphics using a spreadsheet, some 
types, such as pictographs, call for draw- 
ing tools. Your word processor includes 
basic drawing tools. 

To create shapes and SmartArt, use the 
Illustrations group on the Insert tab. 
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Use the Shapes drop-down menu to 
select a simple shape, such as a line, 
arrow, rectangle, or oval. Then drag 


You can select 
complex shapes from 

the SmartArt drop- 
down menu in the 

Illustrations group. 
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Once you have created a shape, you can position the 
shape on your document by selecting and 
dragging it. 



To modify a shape, select it and use the Drawing Tools 
Format tab. 


Groups on the 
Format tab let' 
you modify the 
appearance, 
size, and layout 
of a shape. 


KEYWORDS: shapes, illustrations group, SmartArt, format 
tab 
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Figure 3. U.S. Greenhouse Gas Emissions per Capita and per Dollar of 
GDP, 1990-2010 

This figure shows trends in greenhouse gas emissions from 1990 to 2010 per capita (heavy or- 
ange line), based on the total U.S. population (thin orange line). It also shows trends in emissions 
compared with the real GDP (heavy blue line). Real GDP is the value of all goods and services 
produced in the country during a given year, adjusted for inflation (thin blue line). All data are in- 
dexed to 1990 as the base year, which is assigned a value of 100. For instance, a real GDP value 
of 163 in the year 2010 would represent a 63 percent increase since 1990. 
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Data source: U.S. EPA. 20I2‘ 

Using different colors and thicknesses for the lines 
helps readers distinguish them. 


2000 2002 2004 2006 2008 2010 

Year • 


The grid lines — both vertical and horizontal — 
help readers see the specific quantity for any data 
point on the graph. 


FIGURE 12.14 Line Graph 

Source: U.S. Environmental Protection Agency, 2012, p. 13: http://www.epa.gov/climatechange/pdfs/climateinclicators-fuli-2012.pclf. 


Note that the title is lengthy 
because it specifically names the 
main variables presented in the 
graph. Name all the important data 
in the title; it is better for a title to 
be lengthy than to be imprecise or 
unclear. 

The designer has included a caption 
that explains how to read the graph. 
Because this graph is illustrating 
several items that are measured 
in different units and therefore 
cannot be plotted on the same 
scale (including population and 
greenhouse gases), the designer 
chose to have the y-axis express 
variations from a norm. In this case, 
the norm is represented by the 
quantity of each item in the year 
1990. If this graph illustrated several 
items that were measured in the 
same units, such as the sales figures, 
in dollars, of several salespersons, 
the designer would start the y-axis 
at zero. 

Because the four data lines are 
sufficiently far apart, the designer 
placed the appropriate data label 
next to each line. Alternatively, the 
designer could have used a separate 
color-coded legend. 


Each axis is labeled clearly. 
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Creating Effective Line Graphs 


Follow these three suggestions to create line graphs that are clear and easy to read. 


► If possible, begin the quantity scale at zero. Doing so is the best way to portray 
the information honestly. If you cannot begin at zero, clearly indicate a break in 
the axis, if appropriate. 

► Use reasonable proportions for the vertical and horizontal axes. As with bar 
graphs, make the vertical axis about 25 percent shorter than the horizontal axis. 

► Use grid lines — horizontal, vertical, or both — rather than tick marks when your 
readers need to read the quantities precisely. 
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Pie Charts The pie chart is a simple but limited design used for showing 
the relative sizes of the parts of a whole. You can make pie charts with your 
spreadsheet software. Figure 12.15 shows typical examples. 


You can set your software so that 
the slices use different saturations 
of the same color. This approach 
makes the slices easy to distinguish 
from each other — without any 
distractions or misrepresentations 
caused by a rainbow of colors. 

You can set your software to 
emphasize one slice by separating it 
from the rest of the pie. 
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GUIDELINES 


Creating Effective Pie Charts 


Follow these eight suggestions to ensure that your pie charts are easy to understand 
and professional looking. 


► Restrict the number of slices to no more than seven. As the slices get smaller, 
judging their relative sizes becomes more difficult. 

► Begin with the largest slice at the top and work clockwise in order of decreas- 
ing size, unless you have a good reason to arrange the slices otherwise. 

► If you have several very small quantities, put them together in one slice, to 
maintain clarity. Explain its contents in a footnote. This slice, sometimes called 
"other," follows the other slices. 

► Place a label (horizontally, not radially) inside the slice, if space permits. 

Include the percentage that each slice represents and, if appropriate, the raw 
number. 


To emphasize one slice, use a bright, contrasting color or separate the slice 
from the pie. Do this, for example, when you introduce a discussion of the item 
represented by that slice. 


(■ continued ) 
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► Check to see that your software follows the appropriate guidelines for pie 
charts. Some spreadsheet programs add fancy visual effects that can impair 
comprehension. For instance, many programs portray the pie in three dimen- 
sions, as shown here. 


18% 


33% 


20% 



29% 


□ Freshman 
H Sophomore 

□ Junior 


□ Senior 


In this three-dimensional pie chart about the percentages of a college's student 
body, by year, the sophomore slice looks bigger than the freshman slice, even 
though it isn't, because it appears closer to the reader. To communicate clearly, 
make pie charts two-dimensional. 

► Don't overdo fill patterns. Fill patterns are patterns, shades, or colors that dis- 
tinguish one slice from another. In general, use simple, understated patterns or 
none at all. 

► Check that your percentages add up to 1 00. If you are doing the calculations 
yourself, check your math. 


ILLUSTRATING LOGICAL RELATIONSHIPS 

Graphics can help you present logical relationships among items. For 
instance, in describing a piece of hardware, you might want to show its 
major components. The two kinds of graphics that best show logical relation- 
ships are diagrams and organization charts. 

Diagrams A diagram is a visual metaphor that uses symbols to represent 
relationships among items or their properties. In technical communication, 
common kinds of diagrams are blueprints, wiring diagrams, and schematics. 
Figure 12.16 (on page 324) is a diagram. 
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FIGURE 12.16 Diagram 

Source: U.S. Department of Energy, 2014: 

http://energy.gov/energysaver/articles 

/tips-sealing-air-leaks. 


The purpose of this diagram is to 
help people understand the differ- 
ent areas in their home that need to 
be insulated. In diagrams, items do 
not necesssarily look realistic. Here 
the designer is trying to represent 
logical relationships, not the physi- 
cal appearances of items. 



6 All Ducts 

7 Door Frames 

8 Chimney Flashing 

9 Window Frames 

10 Outlets and Switches 

11 Plumbing & Utility Access 


1 Dropped Ceiling 


2 Recessed Lights 


3 Attic Entrance 


4 Sill Plates 

5 Water and Furnace Flues 


Organization Charts A popular form of diagram is the organization chart, 
in which simple geometric shapes, usually rectangles, suggest logical rela- 
tionships, as shown in Figure 12.17. You can create organization charts with 
your word processor. 


FIGURE 12.17 

Organization Chart 

Source: Adapted from "US Navy 
Organization — An Overview," United 
States Department of the Navy: http:// 
www.navy.mil/navydata/organization 
/org-over.asp. 

An organization chart is often 
used to show the hierarchy in an 
organization, with the most senior 
person in the organization in the 
box at the top. 

Alternatively, an organization chart 
can show the functional divisions 
of a system, such as the human 
nervous system. 
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DOCUMENT ANALYSIS ACTIVITY 


Analyzing a Graphic 


Context for Change 


P n V i r n 



The graphic above illustrates the components of change that the 
Defense Intelligence Agency will consider as it embraces transfor- 
mation. In the sections that follow, we discuss each component in 
turn, beginning with the Future Environment progressing around 
the circle and ending with Recommendations. 


This diagram is from a govern- 
ment report. The questions 
below ask you to think about 
diagrams, as discussed on page 
323 . 

1 . This design resembles a pie 
chart, but it does not have 
the same function as a pie 
chart. What message does 
this design communicate? Is 
it effective? 

2 . Do the colors communicate 
any information, or are they 
merely decorative? If you 
think they are decorative, 
would you revise the design 
to change them in any way? 

3 . What does the phrase 
"Future Environment," above 
the graphic, mean? Is it 
meant to refer only to the 
"Technology" and "Process" 
shapes? 

4 . Is the explanation below the 
graphic clear? Would you 
change it in any way? 


Source: Defense Intelligence Agency, 2003: www.dia.mil/thisisdia/DIA_Workforce_of_the_Future.pdf. 
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DOCUMENT ANALYSIS ACTIVITY 


To analyze an interactive graphic, go to "Document Analysis 
Activities" under "Additional Resources" in Ch. 12: 

macmillanhighered.com/launchpad/techcomm1 1 e. 



How Hard the Wind Will Hit Your Area, and When 

From Tom Giratikanon and David Schutz,"How Hard the Wind 
Will Hit Your Area, and When," Boston Globe, August 26, 201 1 . 
Copyright © 201 1 Boston Globe. Reprinted by permission. All 
rights reserved. 


ILLUSTRATING PROCESS DESCRIPTIONS AND INSTRUCTIONS 

Graphics often accompany process descriptions and instructions (see Chap- 
ter 20). The following discussion looks at some of the graphics used in writing 
about actions: checklists, flowcharts, and logic trees. It also discusses tech- 
niques for showing motion in graphics. 

Checklists In explaining how to carry out a task, you often need to show 
the reader what equipment or materials to gather, or describe an action or a 
series of actions to take. A checklist is a list of items, each preceded by a check 
box. If readers might be unfamiliar with the items you are listing, include 
drawings of the items, as shown in Figure 12.18. You can use the list function 
in your word processor to create checklists. 



FIGURE 12.18 Checklist 
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Regular Maintenance, First 40,000 Miles 






Mileage 




5,000 

10,000 

15,000 

20,000 25,000 

30,000 

35,000 

40,000 

Change oil, replace filter 

/ 

/ 

/ 

/ / 

/ 

/ 

/ 

Rotate tires 

/ 

/ 

/ 

/ / 

/ 

/ 

/ 

Replace air filter 




/ 



/ 

Replace spark plugs 




/ 



/ 

Replace coolant fluid 







/ 

Replace ignition cables 







/ 

Replace timing belt 







/ 


FIGURE 12.19 A Table Used To Illustrate a Maintenance Schedule 


Often you need to indicate that readers are to carry out certain tasks at 
certain intervals. A table is a useful graphic for this kind of information, as 
shown in Figure 12.19. 

Flowcharts A flowchart, as the name suggests, shows the various stages of 
a process or a procedure. Flowcharts are useful, too, for summarizing instruc- 
tions. On a basic flowchart, stages are represented by labeled geometric 
shapes. Flowcharts can portray open systems (those that have a start and a 
finish) or closed systems (those that end where they began). Figure 12.20 (on 
page 328) shows an open-system flowchart and a closed-system flowchart. 
Figure 12.21 (on page 328) shows a deployment flowchart, which you can 
make using the drawing tools in your word processor. 

Logic Trees Logic trees use a branching metaphor. The logic tree shown in 
Figure 12.22 (on page 329) helps students think through the process of regis- 
tering for a course. 

Techniques for Showing Action or Motion In some types of process 
descriptions and instructions, you will want to show action or motion. For 
instance, in an instruction manual for helicopter technicians, you might want 
to illustrate the process of removing an oil dipstick or tightening a bolt, or you 
might want to show a warning light flashing. Although animation and video 
are frequently used to illustrate action or motion in online documents, such 
processes still need to be communicated in static graphics for print documents. 
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Independent 

variable: 


Dependent 

variable: 


Participants 

210 college students 


Random assignment 

to experimental conditions 


I ♦ 


Experimental group 

Control group 

Session 1 : 

Session 1: 

30 minutes violent video 

30 minutes nonviolent 

game play: Wolfenstein 3D 

video game play: Myst 

1 week interval 

1 week interval 

Session 2: 

Session 2: 

1 5 minutes violent video 

1 5 minutes nonviolent 

game play: Wolfenstein 3D 

video game play: Myst 

Noise-blasting opponent 

Noise-blasting opponent 

during "Competitive 

during "Competitive 

Reaction lime lask" 

Reaction lime lask" 

Debriefing 

Debriefing 


Groups compared 


a. Open-system flowchart 

From Don Hockenbury and Sandra E. Hockenbury, DISCOV- 
ERING PSYCHOLOGY, Sixth Edition, Figure 1.3. Copyright 
©2014. Used by permission of the publisher. 

FIGURE 12.20 Flowcharts 



b. Closed-system flowchart 

From W. K. Purves, D. Sadava, G. H. Orians, and H. C. Heller, LIFE:THE SCIENCE OF BIOLOGY, Eighth Edition, 
Fig. 27.14, p. 594. Copyright ©2007. Reprinted by permission of Sinauer Associates. 


A deployment flowchart shows who 
is responsible for carrying out which 
tasks. Here the engineering staff 
writes the requisition, then sends it 
to the Engineering Manager. 



FIGURE 1 2.21 Deployment Flowchart 
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Do the meeting 
times fit your . 
schedule? 




Have you 
completed the _ 
prerequisites? 






Register online. 


Has the 
instructor 
waived the 
prerequisites? 




Register 


Choose 

another 


online. 




Choose 

another 

course. 


FIGURE 1 2.22 Logic Tree 


If the reader is to perform the action, show the action from the reader’s 
point of view, as in Figure 12.23. 

Figure 12.24 illustrates four additional techniques for showing action. 
These techniques are conventional but not universal. If you are addressing 
readers from another culture, consult a qualified person from that culture to 
make sure your symbols are clear and inoffensive. 



a. Use arrows or other symbols to suggest 
the direction in which something 
is moving or should be moved. 






b. Starburst lines suggest 
a blinking light. 



d. An image of an object both before 
and after the action suggests the 
action. 



FIGURE 12.23 Showing 
Action from the Reader's 
Perspective 

In many cases, you need 
to show only the person's 
hands, not the whole body. 


FIGURE 1 2.24 Showing Action or Motion 
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Fora tutorial on photo 
isTJ editing, go to Ch. 1 2 > 
Additional Resources > Tutorials: 

macmillanhighered.com 
/launchpad/techcomml 1e. 


ILLUSTRATING VISUAL AND SPATIAL CHARACTERISTICS 

To illustrate visual and spatial characteristics, use photographs, screen shots, 
line drawings, and maps. 

Photographs Photographs are unmatched for reproducing visual detail. 
Sometimes, however, a photograph can provide too much information. In 
a sales brochure for an automobile, a glossy photograph of the dashboard 
might be very effective. But in an owner’s manual, if you want to show how 
to use the trip odometer, use a diagram that focuses on that one item. 

Sometimes a photograph can provide too little information. The item you 
want to highlight might be located inside the mechanism or obscured by 
another component. 




GUIDELINES 


Presenting Photographs Effectively 


Follow these five suggestions to make sure your photographs are clear, honest, and 
easy to understand. 


► Eliminate extraneous background clutter that can distract readers. Crop 
the photograph to delete unnecessary detail. Figure 1 2.25 shows examples of 
cropped and uncropped photographs. 

► Do not electronically manipulate the photograph. There is nothing unethical 
about removing blemishes or cropping a digital photograph. However, manipu- 
lating a photograph — for example, enlarging the size of the monitor that comes 
with a computer system — is unethical. 

► Help readers understand the perspective. Most objects in magazines and 
journals are photographed at an angle to show the object's depth as well as its 
height and width. 

► If appropriate, include some common object, such as a coin or a ruler, in the 
photograph to give readers a sense of scale. 

► If appropriate, label components or important features. 


Screen Shots Screen shots — images of what appears on a computer moni- 
tor or some other screen — are often used in manuals to show users what 
the screen will look like as they perform tasks with the device. Readers who 
see that the screen shot accurately portrays what appears on their own 
devices are reassured and therefore better able to concentrate on the task 
they are trying to perform. Figure 12.26 is an example of how screen shots 
are used. 
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FIGURE 12.25 Cropping a Photograph 

Sometimes, writers and designers crop photographs to save space. Ideally, you should crop a photo because 
it helps you make your point. If you want to show how vulnerable to natural forces the structure in the 
photograph is, the left-hand version is better because it emphasizes the vastness of the sea. But if you want 
to discuss the ways the structure has been designed and built to resist natural forces, the right-hand version 
is better. 

Source: Kenneth Wiedemann/Getty Images 


..aJiAT&T 3G 


2:06 PM 


Settings ' Sounds 


A Silent 


Vibrate 


□ 


A Ring 


Vibrate 


J OFF 





Ringtone 


houston_problem > 


New Text Message 


None > 


New Voicemail 


New Mail 


This screen shot, from a user guide 
on NASA's website, shows users how 
to select a ringtone. 


FIGURE 1 2.26 Screen Shot 

Source: NASA, 2013: http://www.nasa.gov/connect 
/sounds/iphone_install_directions.html. 
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► TECH TIP 


HowTo Create and Insert Screen Shots 


To show your reader what appears in a window on your com- 
puter monitor, you can insert a screen shot. 


Select Screenshot from the Illustrations 

group on the Insert tab. 

You will see a small version of each 
window you have open on your desktop. 
Click the screen you want to show your 
readers, and Word will insert the picture 
into your document. 




If your active screen has a 
dialog box open, you will see it 
pictured under Available 
Windows. Click on the picture oi 
the dialog box to insert it. 


To insert part of an active screen other than a dialog box, 
select Screen Clipping. You will see the active screen with a 
white shade over it. Use your cursor to draw a rectangular box 
around the part that you want in your screen shot. 



You can modify screen shots by using the Picture Tools For- 
mat tab. For example, you can use the Crop tool in the Size 
group to hide unnecessary details. 


If you plan to create many screen shots, consider using soft- 
ware designed to capture and edit screen images efficiently. 
Search the Internet for "screen capture software," such as 
TechSmith's Snaglt. 


KEYWORDS: screen shot, format tab, crop 


Line Drawings Line drawings are simplified visual representations of 
objects. Line drawings offer three possible advantages over photographs: 

• Line drawings can focus readers’ attention on desired information better 
than a photograph can. 

• Line drawings can highlight information that might be obscured by bad 
lighting or a bad angle in a photograph. 

• Line drawings are sometimes easier for readers to understand than 
photographs are. 

Figure 12.27 shows the effectiveness of line drawings. 

You have probably seen the three variations on the basic line drawing 
shown in Figure 12.28. 
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This drawing, which accompanies a manual about the Americans with Disabilities 
Act, illustrates the idea that "wheelchair seating locations must provide lines of sight 
comparable to those provided to other spectators." A photograph could not show 
this concept as clearly as this drawing does. 



FIGURE 12.27 Line Drawing 

Source: U.S. Department of Justice, 2010: www.ada.gov/stadium.pdf. 



FIGURE 1 2.28 Phantom, Cutaway, and Exploded Views 
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Include a scale and a legend if the 
map is one that is not thoroughly 
familiar to your readers. Also, use 
conventional colors, such as blue 
for water. 



FIGURE 12.29 Map 


Maps Maps are readily available as clip art that can be modified with a 
graphics program. Figure 12.29 shows a map derived from clip art. 


Creating Effective Graphics for 
Multicultural Readers 

Whether you are writing for people within your organization or outside it, con- 
sider the needs of readers whose first language is different from your own. Like 
words, graphics have cultural meanings. If you are unaware of these meanings, 
you could communicate something very different from what you intend. The 
following guidelines are based on William Horton’s article “The Almost Univer- 
sal Language: Graphics for International Documents” (1993). 

• Be aware that reading patterns differ. In some countries, people read from 
right to left or from top to bottom. In some cultures, direction signifies 
value: the right-hand side is superior to the left, or the reverse. You need 
to think about how to sequence graphics that show action or where to 
put “before” and “after” graphics. If you want to show a direction, as in an 
informal flowchart, consider using arrows to indicate how to read the chart. 

• Be aware of varying cultural attitudes toward giving instruction. Instructions 
for products made in Japan are highly polite and deferential: “Please 
attach the cable at this time.” Some cultures favor spelling out general 
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principles but leaving the reader to supply the details. To people in these 
cultures, instructions containing a detailed close-up of how to carry out a 
task might appear insulting. 

• Deemphasize trivial details. Because common objects, such as plugs on 
the ends of power cords, come in different shapes around the world, draw 
them to look generic rather than specific to one country. 

• Avoid culture-specific language, symbols, and references. Don’t use a 
picture of a mouse (the furry rodent) to symbolize a computer mouse 
because the device is not known by that name everywhere. Avoid the 
casual use of national symbols (such as the maple leaf or national flags); 
any error in a detail might offend your readers. Use colors carefully: red 
means danger to most people from Western cultures, but it is a celebratory 
color to the Chinese. 

• Portray people very carefully. Every aspect of a person’s appearance, from 
clothing to hairstyle to physical features, is culture- or race-specific. A 
photograph of a woman in casual Western attire seated at a workstation 
would be ineffective in an Islamic culture where only a woman’s hands 
and eyes may be shown. Horton (1993) recommends using stick figures or 
silhouettes that do not suggest any one culture, race, or sex. 

• Be particularly careful in portraying hand gestures. Many Western hand 
gestures, such as the “okay” sign, are considered obscene in other cultures, 
and some people consider long red fingernails inappropriate. Use hands 
in graphics only when necessary — for example, to illustrate carrying out a 
task — and obscure the person’s sex and race. 

Cultural differences are many and subtle. Learn as much as possible about 
your readers and about their culture and outlook, and have your graphics 
reviewed by a native of the culture. 


WRITER'S CHECKLIST 


CD Does the graphic have a purpose? (p. 297) 

CD Is the graphic simple and uncluttered? (p. 297) 

CD Does the graphic present a manageable amount of 
information? (p. 297) 

CD Does the graphic meet readers' format expectations? 
(p. 297) 

CD Is the graphic clearly labeled? (p. 297) 

CD Is the graphic honest? (p. 298) 

CD Does the graphic appear in a logical location in the 
document? (p. 298) 


CD Is the graphic introduced clearly in the text? (p. 298) 

CD Is the graphic explained in the text? (p. 298) 

CD Is the graphic clearly visible in the text? (p. 299) 

CD Is the graphic easily accessible to readers? (p. 299) 

CD If you want to use an existing graphic, do you have 
the legal right to do so? (p. 301) If so, have you cited its 
source appropriately? (p. 302) 

CD Is the graphic inoffensive to your readers? (p. 334) 
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EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . Find out from the admissions department at your college 
or university the number of students enrolled from the 
different states or from the different counties in your state. 
Present this information in four different kinds of graphics: 

a. map 

b. table 

c. bar graph 

d. pie chart 

In three or four paragraphs, explain why each graphic 
is appropriate for a particular audience and purpose 
and how each emphasizes different aspects of the 
information. 


2. Design a flowchart for a process you are familiar with, 
such as applying for a summer job, studying fora test, 
preparing a paper, or performing some task at work. 
Your audience is someone who will be carrying out the 
process. 

3. The following table provides statistics on federal 
research and development expenditures (U.S. Census 
Bureau, 201 3, Table 81 5). Study the table, and then 
perform the following tasks: 

a. Create two different graphics, each of which 
compares federal R&D funding in 201 1 and 201 2. 

b. Create two different graphics, each of which 
compares defense and nondefense R&D funding in 
either 2011 or 201 2. 


Table 815. Federal Research and Development (R&D) by Federal Agency: Fiscal 
Year 2011 and 2012 


[In millions of dollars (14-1.368 represents S144, 368.000.000). For fiscal years ending September 30. R&D refers to actual research and 
development activities as well as R&D facilities. R&D facilities (also known as R&D plants) includes construction, repair, or alteration of 
physical plant used in the conduct of R&D. Based on Office of Management and Budget data] 


Federal agency 

Total research and development 

Defense R&D 

Nondefense R&D 

Department of Defense 

Science and technology 

All other Department of Defense R&D 

Health and Human Services 

National Institute of Health 

All other Health and Human Services R&D 

Department of Energy 

Atomic Energy Defense 

Office ol Science 

Energy R&D 

NASA 

National Science Foundation 

Department of Agriculture 

Department of Commerce 

National Oceanic and Atmospheric 

Administration 

National Institute of Standards and 
Technology 


2011 

2012 

Federal agency 

2011 

2012 

144.368 

140,565 




83.193 

78.745 

Department of Veterans Affairs 

1.160 

1.164 

61.176 

61.820 

Department of Homeland Security 

760 

617 



Department of Transportation 

954 

945 

79,112 

74.464 

Department of Interior 

757 

796 

12,761 

13,530 

U.S. Geological Survey 

640 

675 

66,361 

60.935 

Environmental Protection Agency 

582 

568 

31.183 

31.143 

Department of Education 

362 

392 

29,831 

30.046 

Smithsonian 

259 

243 

1.352 

1,097 

International Assistance Programs 

121 

121 



Department of Housing and Urban 



10.673 

11,019 

Dovolopment 

79 

57 

4.081 

4.281 

Department of Stale 

75 

75 

4,461 

4,463 

Nuclear Regulatory Commission 

99 

83 

2.131 

2,275 

Department of Justice 

109 

92 

9.099 

9,399 

Social Security Administration 

42 

8 

5.494 

5.614 

U.S. Postal Service 

14 

14 

2.135 

2.331 

Tonncssoo Valley Authority 

18 

15 

1.217 

1,263 

Army Corps of Engineers 

11 

11 

629 

581 

Telecommunications Development 





Agency 

7 

4 

532 

555 

Department of Labor 

4 

4 


Source: American Association for the Advancement of Science (AAAS). AAAS Report XXXVI: Research and Development FY2013. annual 
(copyright). See also <http://www.aaas.org/spp/rd/rdroport2013/>. 
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4 . For each of the following four graphics, write a 

paragraph evaluating its effectiveness and describing 
how you would revise it. 
a. Majors 



2012 

2013 

2014 

Civil Engineering 

236 

231 

253 

Chemical Engineering 

126 

134 

142 

Comparative Literature 

97 

86 

74 

Electrical Engineering 

317 

326 

401 

English 

714 

623 

592 

Fine Arts 

112 

96 

72 

Foreign Languages 

608 

584 

566 

Materials Engineering 

213 

227 

241 

Mechanical Engineering 

196 

203 

201 

Other 

46 

42 

51 

Philosophy 

21 1 

142 

151 

Religion 

86 

91 

72 


b. Number of Members of the U.S. Armed Forces in 
2012 (in Thousands) 



c. Expenses at Hillway Corporation 


■ Overhead 

■ Miscellaneous 

■ Insurance 

■ Benefits 

■ Research 

■ Insurance 
Salaries 


d. Costs of the Components of a PC 
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5. The following three graphs illustrate the sales of two 
products — Series 1 and Series 2 — for each quarter 
of 2014. Which is the most effective in conveying 
the information? Which is the least effective? What 
additional information would make the most-effective 
graph better? 


a. 


2014 Sales of Series 1 and 2, by 
Quarters 


6000 

4000 

2000 

0 



Quarters 


□ Series 1 
■ Series 2 



6. Using a search engine, search for "infographics college 
tuition." Find two infographics that present information 
on similar topics, such as tuition costs for public and 
private colleges and universities, average tuition costs 
in each of the fifty states, or the relationship between 
tuition costs and future earnings potential. Write a 

1 ,000-word memo to your instructor in which you 
identify the audience and purpose of the infographics 
and compare and contrast them using such criteria as 
audience, purpose, clarity, visual appeal, use of different 
types of graphics, and citation of the data sources. 
Which infographic do you think is better? Why? 

7. Locate a graphic on the web that you consider 
inappropriate for an international audience because 
it might be offensive or unclear to readers in some 
cultures. Imagine an intended audience for the graphic, 
such as people from the Middle East, and write a brief 
statement explaining the potential problem. Finally, 
revise the graphic so that it would be appropriate for its 
intended audience. 


2014 Sales of Series 1 and 2, by 
Quarters 

5000 
4000 
3000 
2000 
1000 
0 


12 3 4 

Quarters 


□ Series 1 

□ Series 2 
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CASE 12: Creating Appropriate Graphics To Accompany a Report 



Following a series of texting-related driving accidents, a representative in your state 
legislature has decided to introduce legislation restricting the use of cell phones while 
driving. As an assistant to the state's insurance commissioner, you have been asked to 
collect data on how cell-phone use affects driving. The representative hopes to use these 
data to make his case for the legislation. When you present your findings to your supervisor, 
she asks that you pare them down to the facts most relevant to the representative. She also 
asks that you consider presenting some of the data graphically. To get to work improving 
your research, go to "Cases"under "Additional Resources" in Ch. 12: macmillanhighered 
.com/launchpad/techcomml 1 e. 
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THIS CHAPTER FOCUSES ON techniques for improving the usability of 
documents and websites. In technical communication, usability refers to how 
easily a person can use a document, site, or software program to carry out a task. 
In other words, usability measures how successfully a document achieves its 
purpose and meets its audience's needs. More specifically, usability refers to five 
factors related to a person's use of the item (Nielsen, 201 2): 

• Ease of learning: the time it takes a person to learn to use the item 

• Efficiency of use: the time it takes a person to carry out a task after learning 
how to do it 

• Memorability: a person's ability to remember how to carry out a task 

• Error frequency, severity, and recovery: the number and severity of errors a 
person makes in carrying out a task, and the ease with which a person recovers 
from these errors 

• Subjective satisfaction: how much a person likes (or dislikes) carrying out the 
task 


Understanding Reviewing, 

Evaluating, and Testing 

As a writer, you can improve the usability of documents and websites by 
reviewing, evaluating, and testing them. 

• Reviewing refers to three techniques — revising, editing, and proofreading — 
for studying and changing your draft in order to make it easier to use. You 
have used these techniques in this writing course and in previous courses. 

• Evaluating refers to having other people help you by reading the draft and 
communicating with you about its strengths and weaknesses. You probably 
have had people help you evaluate some of your drafts in the past. 

• Testing refers to formal techniques of observing people and analyzing 
their actions as they try to use your draft to carry out tasks. You likely have 
not used testing before. 

Figure 13.1 (on page 343) shows the relationships among reviewing, evaluat- 
ing, and testing. 

How do you know whether you should go straight from reviewing to pub- 
lication or whether you need to have the draft evaluated and perhaps tested? 
Typically, you consider three factors: 

• Importance. If a document or site is important, evaluate and test as much 
as you can. For instance, an annual report is so important that you want 
to do everything you can to make it perfect. Your company’s website also 
is crucial. You keep evaluating and testing it even after it is launched. A 
routine memo describing a workaround for a technical problem is not as 
important. Review it yourself, and then send it out. 
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For more about audience and 
purpose, see Ch. 5. 



FIGURE 13.1 Relationships Among Reviewing, Evaluating, and Testing 

The solid lines represent the publication process. At point (a), the writer reviews the draft and then 
decides either to publish it as is (d) or to have it evaluated (b). If the draft is evaluated (b), it is next 
either published (d) or tested (c). After the draft is tested, it is published (d). The broken lines represent 
instances in which the draft might be sent back for further work. At point (e), a published document 
or website might be reviewed (a) and revised — partially or completely — to make it more usable. 


• Time. Almost every document has a deadline, and almost every deadline 
comes too quickly. If the document is even moderately important and you 
have the hours, days, or weeks to evaluate and test it, do so. 

• Money. It costs money to evaluate and test drafts, including employee 
time and fees for test participants. If there is no good reason to spend the 
money, don’t. 


Reviewing Documents and Websites 

Reviewing a document or website is the process of studying and changing a 
draft to make it easier to use. Reviewing a document consists of three tasks: 
revising, editing, and proofreading. In carrying out these tasks, you will likely 
work from larger issues to smaller issues. You will first review the document 
as a whole (for scope, organization, and development), saving the smaller 
issues (such as sentence-level concerns) for later. That way, you don’t waste 
time on awkward paragraphs or sentences that you might eventually throw 
out. 

REVISING 

Revising is the process of looking again at your draft to see if your initial 
assumptions about your audience, purpose, and subject still pertain, and 
then making any necessary changes. These changes can range from minor, 
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such as adding one or two minor topics, to major, such as adding whole new 
sections and deleting others. 

For example, imagine you are revising a set of instructions to help new sales 
associates at your company understand how to return unsold merchandise 
to the supplier for credit. Since you started working on the instructions last 
month, your company has instituted a new policy: sales associates must write 
statements to management analyzing the costs and benefits of returning the 
unsold merchandise versus discounting it heavily and trying to sell it. Now you 
need to do some additional research to be sure you understand the new policy, 
gather or create some examples of the kinds of statements sales associates 
will be expected to submit, write new instructions, and integrate them into 
your draft. You thought you were almost done, but you aren’t. It happens. 

EDITING 

Having revised the draft, you think it is in good shape. It meets the needs 
of its readers, it fulfills your purpose or purposes, and it covers the subject 
effectively, presenting the right information. Now it’s time for editing: going a 
little deeper into the draft. 


4 \ 


GUIDELINES 


Editing the Draft 


After you finish your draft, look through it to make sure the writing is clear and effec- 
tive. Start with the big picture by answering these four questions: 


► Is the design effective? Documents and sites should look professional and attrac- 
tive, and they should be easy to navigate. Will your readers find it easy to locate 
the information they want? For more on design, see Chapter 1 1 . 

► Does your draft meet your readers' expectations? If, for instance, the readers 
of a report expect a transmittal letter, they might be distracted if they don't see 
one. Check to make sure that your draft includes the information they expect and 
looks the way they expect. Be especially careful if your document or site will be 
used by people from other cultures, who might have different expectations. For 
more on writing for multicultural readers, see Chapter 5, page 99. 

► Is your draft honest, and does it adhere to appropriate legal standards? Have 
you presented your information honestly, without being misleading and without 
omitting information that might counter your argument? Have you adhered to 
appropriate legal standards of intellectual property, such as copyright law? For 
more on ethical and legal issues, see Chapter 2. 

► Do you come across as reliable, honest, and helpful? Check to see that your 
persona is fully professional: modest, understated, and cooperative. For more on 
persona, see Chapter 8, page 1 84. 


Next, answer these four questions related to the organization and development of 
the draft: 

► Have you left out anything in turning your outline into a draft? Check your 
outline to see that all the topics are included in the document itself. Or switch to 


For more about revising, see Ch. 3, 
pp. 52-54. 


( continued ) 
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the outline view in your word processor so that you can focus on the headings. Is 
anything missing? For more on the outline view, see Chapter 3, page 46. 

► Is the organization logical? Your draft is likely to reflect several different organi- 
zational patterns. For instance, the overall pattern might be chronological. Within 
that pattern, sections might be organized from more important to less important. 
Looking at the headings in the outline view, can you see the patterns you used, 
and do those patterns seem to work well? For more on organizational patterns, 
see Chapter 7. 

► Is the emphasis appropriate throughout the draft? If a major point is treated 
only briefly, mark it for possible expansion. If a minor topic is treated at great 
length, mark it for possible condensing. 

► Are your arguments well developed? Have you presented your claims clearly 
and emphatically? Have you done sufficient and appropriate research to gather 
the right evidence to support your claims effectively? Is your reasoning valid and 
persuasive? For more on conducting research, see Chapter 6. For more on using 
evidence effectively, see Chapter 8, page 1 76. 

Finally, answer these four questions related to the verbal and visual elements of the 

draft: 

► Are all the elements presented consistently? Check to see that parallel items 
are presented consistently. For example, are all your headings on the same level 
structured the same way (for example, as noun phrases or as gerunds, ending 
in -/ng)? And check for grammatical parallelism, particularly in lists, but also in 
traditional sentences. For more on parallelism, see Chapter 1 0, page 227. 

► Are your paragraphs well developed? Does each paragraph begin with a clear 
topic sentence that previews or summarizes the main point? Have you included 
appropriate and sufficient support to validate your claims? For more on para- 
graph development, see Chapter 9. 

► Are your sentences clear and correct? Review the draft to make sure each 
sentence is easy to understand, is grammatically correct, and is structured to 
emphasize the appropriate information. For more on writing effective sentences, 
see Chapter 1 0. 

► Have you used graphics appropriately? Do you see more opportunities to 
translate verbal information into graphics to make your communication easier to 
understand and more emphatic? Have you chosen the proper types of graphics, 
created effective ones, and linked them to your text? For more on graphics, see 
Chapter 12. 


Editing your draft thoroughly requires a lot of work. Naturally, you hope 
that once you’re done editing, you will never need to go back and retrieve 
that earlier draft. But experienced writers know that things don’t always go 
that smoothly. Half the time, when you throw out a sentence, paragraph, or 
section that you absolutely know you will never need again, you soon real- 
ize you need it again. For this reason, it’s smart to use your word processor’s 
change-tracking function and archive all the drafts of everything you write. 
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The easiest way to do this is to use a version number at the end of the 
file name. For example, the first draft of a Lab Renovation proposal is 
LabRenPropVl. When it comes time to edit that draft, open that file and 
immediately rename it LabRenPropV2. 

PROOFREADING 

Proofreading is the long, slow process of reading through your draft one last 
time to make sure you have written what you intended to write. You are 
looking for minor problems caused by carelessness or haste. For instance, 
have you written filename on one page and/ile name on another? Have you 
been consistent in expressing quantities as numerals or as words? Have you 
been consistent in punctuating citations in your list of works cited? Although 
your software can help you with some of these chores, it isn’t sophisticated 
enough to do it all. You need time — and willpower. 

Look particularly for problems in word endings. For instance, a phrase 
such as “we studying the records from the last quarter” is a careless error 
left over from an earlier draft of the sentence. Change it to “we studied the 
records from the last quarter.” Also look for missing and repeated words: “We 
studied the from the last quarter”; “We studied the the records from the last 
quarter.” 

How do you reduce your chances of missing these slips? Read the draft 
slowly, out loud, listening to what you have written and marking things that 
look wrong. After you fix those problems, go through the draft one more time, 
one line at a time, looking for more problems. Some instructors suggest read- 
ing the document backward — last page first, last line first, right to left — so you 
can focus on the individual words. If you can stand doing it, do it. You might 
also consider mixing up the pages of your document (ensuring that you’ve 
numbered them first) and reading them out of sequence so that you can focus 
on words and sentences without getting lost in the argument’s flow. 


Conducting Usability Evaluations 

What is a usability evaluation? To evaluate the usability of a draft, you ask 
someone to study the draft, looking for ways to improve its usability. That 
person then communicates his or her impressions and suggestions, either in 
writing or in an interview. 

You can perform usability evaluations of existing or prototype documents 
or sites. A prototype is a model that is built to simulate the look and feel of an 
item before it is produced commercially. In technical communication, a pro- 
totype is typically an early draft of a document, website, or software program. 
A prototype can range in sophistication from a simple drawing of a computer 
screen to a fully functioning system that looks exactly like a commercial 
product. Figure 13.2 (on page 346) shows an array of free blank templates that 
can be revised and used to create a home page of a website. 
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FIGURE 1 3.2 A Website Showing Sample Templates 

Wix provides hundreds of different web templates, complete with images, geared to particular subjects, 
such as businesses, restaurants, and photography. This figure shows a few of the blank templates offered 
by the company. The user would download a blank template and plug information into it, creating a 
working prototype. With this prototype, the user could then evaluate how well the design works. 

Reprinted by permission ofWix.com. 


Most types of formal usability evaluations involve three categories of 
people in addition to the writer: 

• Users. In technical communication, users are people who use a document, 
site, or program, usually as part of their jobs. They’re your primary 
audience, so they are an important source of feedback. They can be 
current or future users; they can be novice, experienced, or expert users. 
They are probably not people who work with you for the company that 
makes the product, because such people are likely to have specialized 
knowledge that would make them atypical. 

• Subject-matter experts (SMEs). An expert in the subject of the document, 
website, or software can be very useful in evaluating a draft. For instance, 
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a database engineer is presumably an SME in database software programs. 
This person probably could see more — and different — potential problems 
in a new database program than a typical user could. He or she might also 
be the person in charge of carrying out the usability evaluation. 

• Usability experts. An expert in ergonomics, human-computer interaction, 
usability engineering, or cognitive psychology typically designs the 
usability evaluation. That is, he or she determines which questions to ask 
about the draft and how to most effectively and efficiently obtain answers. 
He or she might also carry out the evaluation. Or, a usability expert might 
evaluate a draft himself or herself. 

Although there are many varieties, usability evaluations usually take one 

of five major forms: 

• Surveying or interviewing users. Evaluators survey or interview users to 
learn about the strengths and weaknesses of a document or site. These 
techniques sometimes reveal problems that can be fixed; for instance, 
you might learn that your users would really like to have a printed list of 
keyboard shortcuts to tape to the office wall. More often, however, these 
techniques provide attitudinal information; that is, they reveal users’ 
attitudes about aspects of using the draft. 

• Observing users. To understand how people use an existing document or 
site, evaluators go to their workplaces and observe them as they work. 
Observations can reveal, for example, that typical users are unaware of 

a feature that you assumed they used. This insight can help you see that 
you need to make that feature easier to find and use. Arrange the visit 
beforehand, and bring food to establish good will. 

• Interviewing SMEs and usability experts. An evaluator might ask an expert 
to study the draft for usability and then interview that person, asking 
general questions about the strengths and weaknesses of the draft or 
focused questions about particular aspects of the draft. One well-known 
version of an expert evaluation is called a cognitive walk-through, in which 
the evaluator asks an expert to carry out a set of tasks, such as signing 
up for RSS (rich site summary or really simple syndication) on a blog, a 
prototype, or an existing site. The evaluator watches and notes the expert’s 
actions and comments. Another version of an expert evaluation is called 

a heuristic evaluation. A heuristic is a guideline or desirable characteristic, 
such as that every page of a website should include an easy-to-find link to 
the home page. A heuristic evaluation, then, is an assessment of how well 
a draft adheres to a set of guidelines. After an expert conducts a cognitive 
walk-through or a heuristic evaluation, the evaluator interviews the 
expert. 

• Conducting focus groups. A focus group is a meeting at which a group of 
people discuss an idea or product. Typically, the people are current or 
prospective users. Let’s say your company sells a software program called 


For more about interviewing and 
about writing questionnaires, see Ch. 
6,pp. 136 and 138. 
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FloorTraxx, which helps people design custom floors. A focus group might 
consist of FloorTraxx customers and perhaps other people who have 
indicated an interest in designing custom floors for houses. The moderator 
would lead a discussion that focused on what the customers liked and 
disliked about the product, whether they were satisfied with the results, 
and what changes they would recommend in an updated version. The 
moderator would also seek to learn what information the prospective 
customers would need before deciding to purchase the product. 

• Using a commercial usability service. Companies such as UserTesting 
.com offer usability testing of websites. You specify how many “users” 
you wish to have evaluate your site, their demographics (such as age, sex, 
web experience, and nationality), the context in which they are to use 
the site, a set of simple tasks they are to carry out, and a set of questions 
(such as “What do you like best about the site?”). You then receive a brief 
report from each person who evaluated your site and a video of the person 
thinking aloud while trying to carry out the tasks. Although such usability 
services claim that they are performing usability testing, in fact they are 
performing basic evaluations; real usability testing always involves real 
users. Real usability testing, as described in the next section, provides 
more detailed information because the testing team conducts the test in a 
controlled laboratory environment and can interact more extensively with 
test participants. 

If your users include people from other cultures, be sure to include people 
from these cultures in your interviews and focus groups. If possible, use 
interviewers from the culture of the people you are interviewing. Vatrapu and 
Perez-Quinones (2006) have shown that people from other cultures are some- 
times reluctant to criticize a draft for fear of embarrassing the interviewer. 
When the interviewer is from the same culture, however, people are more 
forthcoming. 

After completing any usability evaluation, you need to gather the impor- 
tant information that you learned and share it with others in your company 
through a presentation, a website, or a collection of documents on the com- 
pany intranet. 


Conducting Usability Tests 

Usability testing draws on many of the same principles as usability evalu- 
ations. For example, in a test, you start by determining what you want to 
learn. You choose test participants carefully, and you repeat the test with 
many participants. You change the draft and retest with still more partici- 
pants. You record what you have learned. 

The big differences between usability evaluation and usability testing are 
that testing always involves real users (or people who match the character- 
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istics of real users) carrying out real tasks, often takes place in a specialized 
lab, is recorded using more sophisticated media, and is documented in more 
formal reports that are distributed to more people. 

This section covers four topics: 

• the basic principles of usability testing 

• preparing for a usability test 

• conducting a usability test 

• interpreting and reporting the data from a usability test 

THE BASIC PRINCIPLES OF USABILITY TESTING 

Three basic principles underlie usability testing: 

• Usability testing permeates product development. Usability testing involves 
testing the document, site, or software rigorously and often to make sure 
it works and is easy to use. Prototypes, newly completed products, and 
products that have been in use for a while are all tested. 

• Usability testing involves studying real users as they use the product. Unlike 
usability evaluations, which often involve experts, testing is done by real 
users, who can provide important information that experts cannot. Real 
users make mistakes that experts don’t make. One well-known example 
relates to computer software that included an error-recovery message that 
said, “Press Any Key to Continue.” The manufacturer received hundreds of 
calls from users who couldn’t find the “Any” key. 

• Usability testing involves setting measurable goals and determining 
whether the product meets them. Usability testing involves determining, 
first, what the user is supposed to be able to do. For instance, in testing 
a wiki, the testers might decide that the user should be able to find the 
“Edit” function and then edit and save a sentence successfully in less than 
30 seconds. 

PREPARING FOR A USABILITY TEST 

Usability testing requires careful planning. According to usability specialist 
Laurie Kantner (1994), planning accounts for one-half to three-quarters of the 
time devoted to testing. In planning a usability test, you must complete eight 
main tasks: 

• Understand users' needs. To understand users’ needs, companies conduct 
focus groups, test existing products, have experts review the product, 
and conduct on-site interviews and observations of real users in the 
workplace. 

• Determine the purpose of the test. Testers can test an idea even before the 
product is designed, to see if people understand it and like it. Or they can 
test a prototype to see if it is easy to use, or a finished product to see if it 
needs any last-minute improvements. 


For more about your audience's 
needs, see Ch. 5. 
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For information about proposals, 
see Ch. 16. 


• Staff the test team. Extensive programs in usability testing involve many 
specialists, each doing one job. Smaller programs involve only a handful of 
people, each doing many jobs. For instance, a testing team might include 
an SME on the product, who can suggest workarounds if necessary; a test 
administrator, who administers the test to participants; a note taker, who 
fills out the evaluation forms and records important comments users 
make; and a videographer, who operates the recording equipment. 

• Set up the test environment. A basic environment includes a room for 
the test participant and another room for the test observers. Figure 13.3 
presents a photograph of a usability lab. 

• Develop a test plan. A test plan is a proposal requesting resources; it 
describes and justifies what the testers plan to do. 

• Select participants. Testers recruit participants who match the profile of 
the intended users. Generally, it is best not to use company employees, 
who might know more about the product than a real user would. 

• Prepare the test materials. Materials for most tests include legal forms 
for the user to complete, an orientation script to help the participant 
understand the purpose of the test, background questionnaires, 
instructions for the participant to follow, and a log in which testers record 
data during the test. 

• Conduct a pilot test. A pilot test is a usability test for the usability test. A 
pilot test can uncover problems with the equipment; the document, site, 
or software being tested; the test materials; or the test design. 



FIGURE 13.3 A Usability Lab 

The two people in the foreground are in the observation room, where they are monitoring the woman 
performing the usability test in the testing room. 

From Gwinnett Business Journal, by permission of Tillman, Allen, Greer. 
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CONDUCTING A USABILITY TEST 

The testing team has to plan the test carefully and stay organized. Typically, 
the team creates a checklist and a schedule for the test day, specifying every 
task that every person, including the test participant, is to carry out. Con- 
ducting the test includes interacting with the test participant both during the 
formal test and later, during a debriefing session. 

Interacting with the Test Participant Among the most popular tech- 
niques for eliciting information from a test participant is the think-aloud test, 
in which the participant says aloud what he or she is thinking while using a 
document or a website. Consider the earlier example of FloorTraxx software 
for designing custom floors. In planning to test the software, you would first 
create a set of tasks for the participant to carry out: 

• Calculate the area of a floor. 

• Calculate the number of tiles needed for a project. 

• Estimate the amount of adhesive needed for a project. 

• Generate the bill of materials needed for a project. 

• Calculate the cost of materials and number of hours of labor for 
a project. 

As the participant carries out each task, he or she thinks aloud about the 
process. Because this process might make the test participant feel awkward, 
the test administrator might demonstrate the process at the beginning of the 
session by thinking aloud while using one of the features on a cell phone or 
finding and using an app on a tablet. 

While the test participant thinks aloud, a note taker records anything that 
is confusing and any point at which the test participant is not sure about what 
to do. If the test participant gets stuck, the administrator asks a leading ques- 
tion, such as “Where do you think that function might be located?” or “What 
did you expect to see when you clicked that link?” Questions should not take 
the user’s knowledge for granted or embarrass the test participant for failing a 
task. For example, “Why didn’t you click the Calculate button?” assumes that 
the user should have seen the button and should have known how to use it. 

In addition, questions should not bias the test participant. When testers 
ask a participant a question, they should try not to reveal the answer they 
want. They should not say, “Well, that part of the test was pretty easy, wasn’t 
it?” Regardless of whether the participant thought it was simple or diffi- 
cult, his or her impulse will be to answer yes. Usability specialists Joseph S. 
Dumas and Janice Redish recommend using neutral phrasing, such as “How 
was it performing that procedure?” or “Did you find that procedure easy or 
difficult?” (1999). In responding to questions, testers should be indirect. If the 
participant asks, “Should I press ‘Enter’ now?” they might respond, “Do you 
think you should?” or “I’d like to see you decide.” 
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To ensure that the test stays on schedule and is completed on time, the 
test administrator should set a time limit for each task. If the test participant 
cannot complete the task in the allotted time, the administrator should move 
on to the next task. 


ETHICS NOTE 


UNDERSTANDING THE ETHICS OF INFORMED CONSENT 

For legal and ethical reasons, organizations that conduct usability testing — especially tests 
that involve recording the test participant's behavior — abide by the principle of informed con- 
sent. Informed consent means that the organization fully informs the participant of the condi- 
tions under which the test will be held, as well as how the results of the test will be used. Only 
if the participant gives his or her consent, in writing, will the test occur. 

When you obtain informed consent for tests that involve recording, be sure to do the follow- 
ing six things: 

• Explain that the test participant can leave at any time and can report any discomfort to the 
testing team at any time, at which point the team will stop the test. 

• Explain that a video camera will be used and, before the recording begins, ask for permis- 
sion to record the test participant. 

• Explain the purpose of the recording and the uses to which it will be put. If, for example, the 
recording might be used later in advertising, the test participant must be informed of this. 

• Explain who will have access to the recording and where it might be shown. A participant 
might object to having the recording shown at a professional conference, for example. 

• Explain how the test participant's identity will be disguised — if at all — if the recording is 
shown publicly. 

• Explain that the test participant will have the opportunity to hear or view the recording and 
then change his or her mind about how it might be used. 


Debriefing the Test Participant After the test, testers usually have 
questions about the test participant’s actions. For this reason, they debrief 
the participant in an interview. The debriefing is critically important, for once 
the participant walks out the door, it is difficult and expensive to ask any 
further questions, and the participant likely will have forgotten the details. 
Consequently, the debriefing can take as long as the test itself did. 

While the participant fills out a posttest questionnaire, the test team 
quickly looks through the data log and notes the most important areas to 
investigate. Their purpose in debriefing is to obtain as much information as 
possible about what occurred during the test; their purpose is not to think of 
ways of redesigning the product to prevent future problems. Usability spe- 
cialists Jeffrey Rubin and Dana Chisnell (2008) suggest beginning the debrief- 
ing with a neutral question, such as “So, what did you think?” This kind of 
question encourages the participant to start off with an important sugges- 
tion or impression. During the debriefing session, testers probe high-level 
concerns before getting to the smaller details. They try not to get sidetracked 
by a minor problem. 





Conducting Usability Tests 


13 


353 


INTERPRETING AND REPORTING THE DATA FROM 
A USABILITY TEST 

After a usability test, testers have a great deal of data, including notes, ques- 
tionnaires, and videos. 'Itirning that data into useful information involves 
three steps: 

• Tabulate the information. Testers gather all the information from the test, 
including performance measures, such as how long it took a participant to 
complete a task, and attitude measures, such as how easy the participant 
found the task. 

• Analyze the information. Testers analyze the information, concentrating on 
the most-important problems revealed in the test and trying to determine 
the severity and the frequency of each one. 

• Report the information. Writing a clear, comprehensive report often leads 
the testers to insights they might not have achieved otherwise. 

Although usability testing might seem extremely expensive and difficult, 
testers who are methodical, open-minded, and curious about how people use 
their documents or websites find that it is the least-expensive and most- 
effective way to improve quality. 
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DOCUMENT ANALYSIS ACTIVITY 


Obtaining Informed Consent 


NASA, the U.S. space agency, 
uses this consent form in its 
usability testing. The questions 
below ask you to examine 
this document in light of the 
guidelines for informed consent 
(p. 352). 

1 . Which concepts of an effec- 
tive informed-consent form, 
as described in the Ethics 
Note on page 352, does this 
form include? 

2 . Which concepts of an effec- 
tive informed-consent form 
does this form not include? 

3 . Are any provisions in this 
form potentially unclear? 


Understanding Your Participation 
Please read this page carefully. 

You have agreed to participate in a usability study that will evaluate [system]. By 
participating in this study, you will help NASA to improve [system] in future rede- 
signs. Our team will observe you and record information about how you work with 
the [system]. We will also ask you to fill out questionnaires about your experience 
and follow-up questions. We will record your comments and actions using written 
notes and video cameras. 

Our team will use the data from your study session, including videotapes, solely 
for the purposes of evaluating the [system] and sharing results of these evaluations 
with [the study sponsor]. Your full name will not be used during any presentation 
or in the results of this study. 

By signing this form, you give permission for NASA to use: 

• Your recorded voice: □ Yes □ No 

• Your verbal statements: □ Yes □ No 

• The videotape of your session: □ Yes □ No 

If you need a break at any time, please inform the study facilitator immediately. If 
you have questions about how the session will proceed, you may ask them at any 
time. You may withdraw from your study session at any time. 

Receipt for [Incentive] 

Please acknowledge that you have received from [NASA, or study sponsor] [the 
exact amount of money, or describe the nonmonetary incentive, if it is merchan- 
dise] for your participation by signing below. Your acceptance of this [incentive] 
does not constitute employment by [NASA, or study sponsor], 

□ I have received my [incentive]. 

If you agree with these terms, please indicate your agreement by signing below: 

Signature: 

Print Name: 

Date: 


Source: National Aeronautics and Space Administration, 2010: www.hq.nasa.gov/pao/portal/usability 
/process/utPlanning.htm. 
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WRITER'S CHECKLIST 


Revising, Editing, and Proofreading 

EH Did you think about how your audience, purpose, and 
subject might have changed since you planned and 
drafted your document or site? (p. 342) 

In editing your draft, did you check to see that 
EH the design is effective? (p. 343) 

\ the draft meets your readers' expectations? (p. 343) 

EH the draft is honest and adheres to appropriate legal 
standards? (p. 343) 

□ you come across as reliable, honest, and helpful? (p. 343) 

□ you have not omitted anything listed on your original 
outline? (p. 343) 

EH the organization of the draft is logical? (p. 344) 

EH the emphasis is appropriate throughout the draft? 

(p- 344) 

EH the arguments are well developed? (p. 344) 

EH the elements of the draft are presented consistently? 

(P- 344) 

\ ' the paragraphs are well developed? (p. 344) 

EH the sentences are clear and correct? (p. 344) 

EH the graphics are used appropriately? (p. 344) 

□ you archived your earlier draft before you started, using 
a logical file-naming system? (p. 344) 

Did you proofread your draft carefully, looking for minor 
problems such as 

□ inconsistent spelling and punctuation? (p. 345) 

□ incorrect word endings? (p. 345) 

□ repeated or missing words? (p. 345) 


Usability Evaluations 

Did you, if appropriate, 

□ survey or interview users? (p. 347) 

EH observe users using your existing document or site? 

(p. 347) 

□ interview SMEs and usability experts? (p. 347) 

I i conduct focus groups? (p.347) 

□ use a commercial usability service? (p. 348) 

Usability Tests 

Did you prepare for the usability test by 

I ] making efforts to understand your users' needs? (p. 349) 

EH determining the purpose of the test? (p. 349) 

□ staffing the test team? (p. 350) 

EH setting up the test environment? (p. 350) 

EH developing a test plan? (p. 350) 

EH carefully selecting participants? (p. 350) 

□ preparing the test materials? (p. 350) 

EH conducting a pilot test? (p. 350) 

Did you conduct the usability test effectively by 
EH interacting appropriately with the participant? (p. 351) 
EH obtaining informed consent? (p. 352) 

I debriefing the participant? (p. 352) 

Did you interpret and report the test data by 
EH tabulating the information? (p. 353) 

EH analyzing the information? (p. 353) 

I ! reporting the information? (p. 353) 
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EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . Edit and proofread the following passage. Be prepared 
to share your work with the class. 

Here are a list of the questions you shouldn't be asked 
by a perspective employer: What is or was your spouse's 
name or job? Has a Workers Compensation claim been 
filed on your behalf? Were you ever injured on the job. 
Do you have any physical empairments that prevents 
you from performing the job for which your applying? 
Have you ever been arrested? If yes, what for? What 
is your hair/eye color? Your height/weight? Have you 
ever been hospitalized? If so, why. Have you ever been 
treated by a psyhiatrist or psychologist? If so, for what 
condition? Is there any health-related reasons you 
may not be able to preform the job for which you're 
applying? How many days were you absent from work 
because of illness? Are you now taking any drugs? 

Have you ever had a problem with for drug adiction or 
alcoholism? 

2. Contact local manufacturing companies and computer- 
hardware and -software companies to see whether 
any of them perform usability testing. Interview a 
person who performs usability testing at one of these 


organizations. Then write a 1 ,000-word memo to your 
instructor describing how the process of conducting 
usability testing at this organization differs from that 
described in this chapter. 

3. If a local company conducts usability testing, see 
whether you can become a test participant. After 
the test, write a 1,000-word memo to your instructor 
describing the experience, focusing on what you 
learned about usability testing. 

4. TEAM EXERCISE Form a group of four or five students, 
and conduct an informal usability test for assembling or 
using one of the following products: 

a. a piece of computer hardware, such as a printer 

b. a piece of software (or a portion of a piece of 
software) 

c. a document that accompanies a piece of software 
(ora portion of one) 

d. a piece of equipment used in your major field of 
study 

e. a smartphone, Bluetooth headset, or similar product 
Submit a brief usability report to your instructor. 


CASE 1 3: Revising a Document for a New Audience 



You work at your university's health center, where your supervisor is looking for ways to 
provide students with more information on obesity, a topic they have been inquiring 
about increasingly. She has located a fact sheet from the National Institutes of Health that 
contains information concerning a specific diet about which students have expressed 
interest. The fact sheet, however, was not developed for a college-student audience, and 
your supervisor would therefore like you to try revising it with your peers in mind. To get 
to work, go to "Cases" under "Additional Resources" in Ch. 13: macmillanhighered.com 
/launchpad/techcomm 1 1 e. 
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REGARDLESS OF WHETHER you use microblogs, instant messaging, text 
messaging, or more traditional applications, you will communicate in writing 
every day on the job. This chapter discusses the four major formats used for 
producing workplace correspondence: letters, memos, emails, and microblog 
posts. Throughout this chapter, the word correspondence refers to all these forms. 


Understanding the Process 
of Writing Correspondence 

The process of writing correspondence is essentially like that of writing any 
other kind of workplace document. The Focus on Process box presents an 
overview of this process, focusing on letters, memos, and emails. The more 
formal the correspondence, the more time you are likely to spend on each of 
these steps. 


FOCUS ON PROCESS 


When writing correspondence, pay special attention to these steps of the writing process. 


PLANNING 


You will need to choose the appropriate type of correspondence 
for your writing situation. 


DRAFTING 


For letters, memos, and email, clearly state your purpose, use 
headings to help your readers, summarize your message, 
provide adequate background, organize the discussion, and 
highlight action items. For microblogs, state your message or 
question clearly. 


REVISING 



EDITING 



PROOFREADING 



You might need to write correspondence quickly, but you 
still need to write carefully. Revise, edit, and proofread 
everything before you publish or send it. See Appendix, Part 
B for help. 
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WRITING CORRESPONDENCE 


Selecting a Type of Correspondence 

When you need to correspond with others in the workplace, your first task is 

to decide on the appropriate type of document. Here are the main character- 
istics of each major type: 

• Letters. Because letters still use centuries-old conventions such as the 
salutation and complimentary close, they are the most formal of the 
four types of correspondence and are therefore most appropriate for 
communicating with people outside your organization or, in some formal 
situations, with people within your organization. 

• Memos. This type of correspondence is moderately formal and therefore 
appropriate for people in your own organization. 

• Email. This type of correspondence is best for quick, relatively informal 
communication with one or many recipients. Recipients can store and 
forward email easily, as well as capture the text and reuse it in other 
documents. In addition, the writer can attach other files to an email message. 

• Microblog posts. Microblog posts such as Twitter tweets or Facebook status 
updates can be useful to address quick questions to a group. This is the 
most informal type of correspondence. 


Presenting Yourself Effectively 
in Correspondence 

When you write business correspondence, follow these five suggestions for 
presenting yourself as a professional: 

• Use the appropriate level of formality. 

• Communicate correctly. 

• Project the “you attitude.” 

• Avoid correspondence cliches. 

• Communicate honestly. 

USE THE APPROPRIATE LEVEL OF FORMALITY 

People are sometimes tempted to use informal writing in informal digital 
applications such as email and microblogs. Don’t. Everything you write on 
the job is legally the property of the organization for which you work, and 
messages are almost always archived digitally, even after recipients have 
deleted them. Your documents might be read by the company president, or 
they might appear in a newspaper or in a court of law. Therefore, use a mod- 
erately formal tone to avoid potential embarrassment. 

too informal Our meeting with United went south right away when they threw 

a hissy fit, saying that we blew off the deadline for the progress 
report. 
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moderately formal In our meeting, the United representative expressed concern that 
we had missed the deadline for the progress report. 

However, you don’t want to sound like a dictionary. 

too formal It was indubitably the case that our team was successful in 

presenting a proposal that was characterized by quality of 
the highest order. My appreciation for your industriousness is 
herewith extended. 

moderately formal I think we put together an excellent proposal. Thank you very 
much for your hard work. 

COMMUNICATE CORRECTLY 

One issue closely related to formality is correctness. As discussed in Chapter 
1, correct writing is free of grammar, punctuation, style, usage, and spelling 
errors. Correctness problems occur most often in email and microblogs. 

Some writers mistakenly think that they do not need to worry about cor- For more about editing and 

rectness because these digital applications are meant for quick communica- proofreading, seeCh. n, pp. 343-45. 
tion. They are wrong. You have to plan your digital correspondence just as 
you plan any other written communication, and you should revise, edit, and 
proofread it. Sending correspondence that contains language errors is unpro- 
fessional because it suggests a lack of respect for your reader — and 
for yourself. It also causes your reader to think that you are careless about 
your job. 

PROJECT THE "YOU ATTITUDE" 

Correspondence should convey a courteous, positive tone. The key to accom- 
plishing this task is using the “you attitude” — looking at the situation from 
the reader’s point of view and adjusting the content, structure, and tone to 
meet his or her needs. For example, if you are writing to a supplier who has 
failed to deliver some merchandise by the agreed-on date, the “you attitude” 
dictates that you not discuss problems you are having with other suppliers; 
those problems don’t concern your reader. Instead, concentrate on explain- 
ing clearly and politely that the reader has violated your agreement and that 
not having the merchandise is costing you money. Then propose ways to 
expedite the shipment. 

Following are two examples of thoughtless sentences, each followed by an 
improved version that shows the “you attitude.” 

accusing You must have dropped the engine. The housing is badly cracked. 

better The badly cracked housing suggests that the engine must have fallen onto 
a hard surface from some height. 

sarcastic You'll need two months to deliver these parts? Who do you think you are, 
the post office? 

Surely you would find a two-month delay for the delivery of parts 
unacceptable in your business. That's how I feel, too. 


BETTER 
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For more about choosing the right 
words and phrases, see Ch. 10, p. 230. 


A calm, respectful tone makes the best impression and increases the chances 
that you will achieve your goal. 

AVOID CORRESPONDENCE CLICHES 

Over the centuries, a group of words and phrases have come to be associated 
with business correspondence; one common example is as per your request. 
These phrases sound stilted and insincere. Don’t use them. 

Figure 14.1 is a list of common cliches and their plain-language equiva- 
lents. Figure 14.2 shows two versions of the same letter: one written in cli- 
ches, the other in plain language. 


LETTER CLICHE 

PLAIN-LANGUAGE EQUIVALENT 

attached please find 

attached is 

enclosed please find 

enclosed is 

pursuant to our agreement 

as we agreed 

referring to your ("Referring to your letter 
of March 1 9, the shipment of pianos . . .") 

"As you wrote in your letter of March 1 9, 
the . . ."(or subordinate the reference at the 
end of your sentence) 

wish to advise ("We wish to advise 
that . . .") 

(The phrase doesn't say anything. Just say 
what you want to say.) 

the writer ("The writer believes that . . .") 

"1 believe . . ." 


FIGURE 14.1 Letter Cliches and Plain-Language Equivalents 


COMMUNICATE HONESTLY 

You should communicate honestly when you write any kind of document, 
and business correspondence is no exception. Communicating honestly 
shows respect for your reader and for yourself. 


ETHICS NOTE 


WRITING HONEST BUSINESS CORRESPONDENCE 

Why is dishonesty a big problem in correspondence? Perhaps because the topics discussed in 
business correspondence often relate to the writer's professionalism and the quality of his or 
her work. For instance, when a salesperson working for a supplier writes to a customer explain- 
ing why a product did not arrive on time, he is tempted to make it seem as if his company — 
and he personally — is blameless. Similarly, when a manager has to announce a new policy that 
employees will dislike, she might be tempted to distance herself from the policy. 

The professional approach is to tell the truth. If you mislead a reader in explaining why the 
shipment didn't arrive on time, the reader will likely double-check the facts, conclude that you 
are trying to avoid responsibility, and end your business relationship. If you try to convince 
readers that you had nothing to do with a new, unpopular policy, some of them will know 
you are being misleading, and you will lose your most important credential: your credibility. 
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LETTER CONTAINING CLICHES LETTER IN PLAIN LANGUAGE 

Dear Mr. Smith: Dear Mr. Smith: 


Referring to your complaint regarding 
the problem encountered with your new 
Trailrider Snowmobile, our Customer 
Service Department has just submitted 
its report. 

It is their conclusion that the malfunction 
is caused by water being present in the 
fuel line. It is our conclusion that you must 
have purchased some bad gasoline. We 
trust you are cognizant of the fact that 
while we guarantee our snowmobiles for 
a period of not less than one year against 
defects in workmanship and materials, 
responsibility cannot be assumed for 
inadequate care. We wish to advise, for 
the reason mentioned hereinabove, that 
we cannot grant your request to repair 
the snowmobile free of charge. 

Permit me to say, however, that the writer 
would be pleased to see that the fuel 
line is flushed at cost, $30. YourTrailrider 
would then give you many years of 
trouble-free service. 

Enclosed please find an authorization 
card. Should we receive it, we shall 
perform the above-mentioned repair and 
deliver your snowmobile forthwith. 

Sincerely yours, 


Thank you for letting us know about 
the problem with your newTrailrider 
Snowmobile. 

Our Customer Service Department has 
found water in the fuel line. Apparently some 
of the gasoline was bad. While we guarantee 
our snowmobiles for one year against 
defects in workmanship and materials, we 
cannot assume responsibility for problems 
caused by bad gasoline. We cannot, 
therefore, grant your request to repair the 
snowmobile free of charge. 

However, no serious harm was done to the 
snowmobile. We would be happy to flush 
the fuel line at cost, $30. YourTrailrider 
would then give you many years of trouble- 
free service. If you will authorize us to do this 
work, we will have your snowmobile back 
to you within four working days. Just fill out 
the enclosed authorization card and drop it 
in the mail. 

Sincerely yours, 


The letter on the right avoids cliches 
and shows an understanding of the 
"you attitude." Instead of focusing 
on the violation of the warranty, it 
presents the conclusion as good 
news: the snowmobile is not ruined, 
and it can be repaired and returned 
in less than a week for a small 
charge. 


FIGURE 14.2 Sample Letters with and Without Cliches 


Writing Letters 

Letters are still a basic means of communication between organizations, with 
millions written each day. To write effective letters, you need to understand 
the elements of a letter, its format, and the common types of letters sent in 
the business world. 

ELEMENTS OF A LETTER 

Most letters include a heading, inside address, salutation, body, complimen- 
tary close, and signature. Some letters also include one or more of the fol- 
lowing: attention line, subject line, enclosure line, and copy line. Figure 14.3 
shows the elements of a letter. 
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Heading. Most organizations use letterhead 
stationery with their heading printed at the top. This 
preprinted information and the date the letter is sent 
make up the heading. If you are using blank paper 
rather than letterhead, your address (without your 
name) and the date form the heading. Whether you 
use letterhead or blank paper for the first page, do 
not number it. Use blank paper for the second and all 
subsequent pages. 


Inside Address. If you are writing to an individual 
who has a professional title — such as Professor, Dr., 
or, for public officials, Honorable — use it. If not, use 
Mr. or Ms. (unless you know the recipient prefers Mrs. 
or Miss). If the reader's position fits on the same line 
as the name, add it after a comma; otherwise, drop it 
to the line below. Spell the name of the organization 
the way the organization itself does: for example, 
International Business Machines calls itself IBM. 
Include the complete mailing address: street number 
and name, city, state, and zip code. 


Attention Line. Sometimes you will be unable to 
address a letter to a particular person because you 
don't know (and cannot easily find out) the name 
of the individual who holds that position in the 
company. 


\i 



DAVIS TREE CARE 
1300 Lancaster Avenue 
Berwyn, PA 19092 
www.davisfortrees.com 


May 11,2015 

Fairlawn Industrial Park 
1910 Ridgeway Drive 
Berwyn, PA 1 9092 

Attention: Director of Maintenance 

Subject: Fall pruning 

Dear Director of Maintenance: 


Do you know how much your trees are worth? That's 
right — your trees. As a maintenance director, you know 
how much of an investment your organization has in its 
physical plant. And the landscaping is a big part of your 
total investment. 

Most people don't know that even the hardiest trees need 
periodic care. Like shrubs, trees should be fertilized and 
pruned. And they should be protected against the many 
kinds of diseases and pests that are common in this area. 

At DavisTree Care, we have the skills and experience to 
keep your trees healthy and beautiful. Our diagnostic 
staff is made up of graduates of major agricultural and 
forestry universities, and all of our crews attend special 
workshops to keep current with the latest information on 
tree maintenance. Add to this our proven record of 43 years 
of continuous service in the Berwyn area, and you have a 
company you can trust. 


Subject Line. The subject line is an optional element 
in a letter. Use either a project number (for example, 
"Subject: Project 31402") or a brief phrase defining 
the subject (for example, "Subject: Price quotation for 
the R13 submersible pump"). 


Salutation. If you decide not to use an attention line 
or a subject line, put the salutation, or greeting, two 
lines below the inside address. The traditional saluta- 
tion is Dear, followed by the reader's courtesy title 
and last name and then a colon (not a comma): 

Dear Ms. Hawkins: 


FIGURE 14.3 Elements of a Letter 
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Letter to Fairlawn Industrial Park m- 
Page 2 
May 11,2015 


May we stop by to give you an analysis of your trees — 
absolutely without cost or obligation? Spending a few 
minutes with one of our diagnosticians could prove to be 
one of the wisest moves you've ever made. Just give us 
a call at 610-555-9187, and we'll be happy to arrange an 
appointment at your convenience. 


Sincerely yours, 

Jasmine Brown 
President 


Enclosure: Davis Tree Care brochure 
c: Darrell Davis, Vice President 


Header for second page. 


Body. In most cases, the body contains at least three 
paragraphs: an introductory paragraph, a concluding 
paragraph, and one or more body paragraphs. 


Complimentary Close. The conventional phrases Sin- 
cerely, Sincerely yours, Yours sincerely, Yours Mery truly, 
and Very truly yours are interchangeable. 


Signature. Type your full name on the fourth line 
below the complimentary close. Sign the letter, in 
ink, above the printed name. Most organizations 
prefer that you include your position under your 
printed name. 


Copy Line. If you want the primary recipient to know 
that other people are receiving a copy of the letter, 
include a copy line. Use the symbol c (for"copy") 
followed by the names of the other recipients (listed 
either alphabetically or according to organizational 
rank). If appropriate, use the symbol cc (for"courtesy 
copy") followed by the names of recipients who are 
less directly affected by the letter. 


Enclosure Line. If the envelope contains documents otherthan the 
letter, include an enclosure line that indicates the number of enclo- 
sures. For more than one enclosure, add the number: "Enclosures (2)." 
In determining the number of enclosures, count only separate items, 
not pages. A three-page memo and a 10-page report constitute only 
two enclosures. Some writers like to identify the enclosures: 

Enclosure: 2014 Placement Bulletin 
Enclosures (2): "This Year at Ammex" 

2014 Annual Report 


FIGURE 14.3 Elements of a Letter ( continued ) 
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Letters follow one of two typical formats: modified block or full block. Fig- 
ure 14.4 illustrates these two formats. 


I 1 14" 

COMPANY LOGO 

5-9 lines 


I 1-3 lines 

Mr. John Smith, Director of Operations 
Macmillan Dental Group 
5667 Elodie Drive 
Woonsocket, RI 02895 


1 


I line 


Dear Mr. Smith: 

t 1 line 


Ellen Matthews 
Sales Associate 


EM/jm 
I 1 line 
Enclosure 

I IV 


a. Modified block format 


COMPANY LOGO 


May 11,2015 


Mr. John Smith, Director of Operations 
Macmillan Dental Group 
5667 Elodie Drive 
Woonsocket, RI 02895 


Dear Mr. Smith: 


Sincerely yours. 


Ellen Matthews 
Sales Associate 


EM/jm 


Enclosure 


b. Full block format — everything aligned along the 
left margin 


FIGURE 14.4 Typical Letter Formats 

The dimensions and spacing shown for the modified block format also apply to the full block format. 


Two other types of letters are 
discussed in this book: the 
transmittal letter in Ch. 18, p. 479, 
and the job-application letter in 
Ch. 15, p. 411. 


COMMON TYPES OF LETTERS 

Organizations send out many different kinds of letters. This section focuses 
on four types of letters written frequently in the workplace: inquiry, response 
to an inquiry, claim, and adjustment. 

Inquiry Letter Figure 14.5 shows an inquiry letter, in which you ask questions. 

Response to an Inquiry Figure 14.6 (on page 368) shows a response to 
the inquiry letter in Figure 14.5. 

Claim Letter Figure 14.7 (on page 369) is an example of a claim letter that 
the writer scanned and attached to an email to the reader. The writer’s deci- 
sion to present his message in a letter rather than an email suggests that he 
wishes to convey the more-formal tone associated with letters — and yet he 
wants the letter to arrive quickly. 
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14 Hawthorne Ave. 
Belleview,TX 75234 

November 2, 2015 


Dr. Andrea Shakir 
Director ofTechnical Services 
Orion Corporation 
721 West Douglas Avenue 
Maryville, TN 31409 

Dear Dr. Shakir: 

I am writing to you because of Orion's reputation as a leader in the 
manufacture of adjustable x-ray tables. I am a graduate student in 
biomedical engineering at the University of Texas, and I am working on an 
analysis of diagnostic equipment for a seminar paper. Would you be able to 
answer a few questions about your Microspot 311? 

1 . Can the Microspot 31 1 be used with lead oxide cassettes, or does it 
accept only lead-free cassettes? 

2. Are standard generators compatible with the Microspot 31 1 ? 

3. What would you say is the greatest advantage, for the operator, of using 
the Microspot 311? For the patient? 

Because my project is due on January 1 5, 1 would greatly appreciate your 
assistance in answering these questions by January 10. Of course, I would 
be happy to send you a copy of my report when it is completed. 

Yours very truly, 

K, S ~torvns 

Albert K. Stern 


You write an inquiry letter to 
acquire information. Explain who 
you are and why you are writing. 
Make your questions precise and 
clear, and therefore easy to answer. 
Explain what you plan to do with 
the information and how you can 
compensate the reader for answer- 
ing your questions. 

This writer's task is to motivate the 
reader to provide some information. 
That information is not likely to 
lead to a sale because the writer is 
a graduate student doing research, 
not a potential customer. 


Notice the flattery in the first 
sentence. 


The writer presents specific 
questions in a list format, making 
the questions easy to read and 
understand. 


In the final paragraph, the writer 
politely indicates his schedule and 
requests the reader's response. Note 
that he offers to send the reader a 
copy of his report. 

If the reader provides 
information, the writer should send 
a thank-you letter. 


FIGURE 14.5 Inquiry Letter 
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In responding to an inquiry letter, 
answer the questions if you can. 

If you cannot, either because you 


don't know the answers or because 



you cannot divulge proprietary 
information, explain the reasons 
and offer to assist with other 


■ft 

ORION 


requests. 


721 WEST DOUGLAS AVE. 
MARYVILLE, TN 31409 


(615)619-8132 

www.orioninstruments.com 


November 7, 2015 

Mr. Albert K. Stern 
1 4 Hawthorne Ave. 

Belleview,TX 75234 

Dear Mr. Stern: 

I would be pleased to answer your questions about the Microspot 31 1 .We think it is 


earlier generator models — the Olympus and the Saturn. We are currently working 
on other wiring kits. 

3. For the operator, the 31 1 increases the effectiveness of the radiological procedure 
while at the same time cutting down the amount of film used. For the patient, it 
reduces the number of repeat exposures and therefore reduces the total dose. 

I am enclosing a copy of our brochure on the Microspot 311. If you would like 


The writer responds graciously. 


the best unit of its type on the market today. 


The writer answers the three ques- 
tions posed in the inquiry letter. 


1 . The 31 1 can handle lead oxide or lead-free cassettes. 

2. At the moment, the 311 is fully compatible only with our Duramatic generator. 
However, special wiring kits are available to make the 31 1 compatible with our 


The writer encloses other 
information to give the reader a 
fuller understanding of the product. 


additional information, please visit our Web site at www.orioninstruments.com/ 
products/microspot31 1 . 1 would be happy to receive a copy of your analysis when it 
is complete. Good luck! 

Sincerely yours, 



The writer uses the enclosure 
notation to signal that she is 
attaching an item to the letter. 


Andrea Shakir, M.D. 

Director of Technical Services 


Enclosure 


The writer indicates that she is for- 
warding a copy to her supervisor. 


c: Robert Anderson, Executive Vice President 


FIGURE 14.6 Response to an Inquiry 
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ROBBINS 

CONSTRUCTION, INC. 

255 Robbins Place, Centerville, MO 65101 | [417] 555-1850 | robbinsconstruction.com 


RC 

- 


August 17, 2015 

Mr. David Larsyn 
Larsyn Supply Company 
311 Elmerine Avenue 
Anderson, MO 63501 


Dear Mr. Larsyn: 

As steady customers of yours for over 1 5 years, we came to you first when 
we needed a quiet pile driver for a job near a residential area. On your 
recommendation, we bought your Vista 500 Quiet Driver, at $ 1 4,900. We have 
since found, much to our embarrassment, that it is not substantially quieter 
than a regular pile driver. 


We received the contract to do the bridge repair here in Centerville after 
promising to keep the noise to under 90 dB during the day. The Vista 500 (see 
enclosed copy of bill of sale for particulars) is rated at 85 dB, maximum. We 
began our work and, although one of our workers said the driver didn't seem 
sufficiently quiet to him, assured the people living near the job site that we 
were well within the agreed sound limit. One of them, an acoustical engineer, 
marched out the next day and demonstrated that we were putting out 1 04 dB. 
Obviously, something is wrong with the pile driver. 

I think you will agree that we have a problem. We were able to secure other 
equipment, at considerable inconvenience, to finish the job on schedule. When 
I telephoned your company that humiliating day, however, a Mr. Meredith 
informed me that I should have done an acoustical reading on the driver before 
I accepted delivery. 


I would like you to send out a technician — as soon as possible — either to repair 
the driver so that it performs according to specifications or to take it back for a 
full refund. 

Yours truly, 






Jack Robbins, President 


Enclosure 


A claim letter is a polite, reasonable 
complaint. If you purchase a defec- 
tive or falsely advertised product 
or receive inadequate service, you 
write a claim letter. If the letter is 
convincing, your chances of receiv- 
ing a satisfactory settlement are 
good because most organizations 
realize that unhappy customers are 
bad for business. In addition, claim 
letters help companies identify 
weaknesses in their products or 
services. 


The writer indicates clearly in the 
first paragraph that he is writing 
about an unsatisfactory product. 
Note that he identifies the 
product by model name. 

The writer presents the background, 
filling in specific details about the 
problem. Notice how he supports 
his earlier claim that the problem 
embarrassed him professionally. 


The writer states that he thinks the 
reader will agree that there was a 
problem with the equipment. 

Then the writer suggests that the 
reader's colleague did not respond 
satisfactorily. 

The writer proposes a solution: that 
the reader take appropriate action. 
The writer's clear, specific account 
of the problem and his professional 
tone increase his chances of receiv- 
ing the solution he proposes. 


FIGURE 14.7 Claim Letter 
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An adjustment letter, a response 
to a claim letter, tells the customer 
how you plan to handle the 
situation. Your purpose is to show 
that your organization is fair and 
reasonable and that you value the 
customer's business. 

If you can grant the request, the 
letter is easy to write. Express your 
regret, state the adjustment you 
are going to make, and end on a 
positive note by encouraging the 
customer to continue doing busi- 
ness with you. 


The writer wisely expresses regret 
about the two problems cited in the 
claim letter. 

The writer describes the actions 
he has already taken and formally 
states that he will do whatever the 
reader wishes. 

The writer expresses empathy in 
making the offer of adjustment. 
Doing so helps to create a bond: 
you and I are both professionals 
who rely on our good reputations. 

This polite conclusion appeals to 
the reader's sense of fairness and 
good business practice. 


WRITING CORRESPONDENCE 

Adjustment Letter Figures 14.8 and 14.9 show “good news” and “bad 
news” adjustment letters. The first is a reply to the claim letter shown in 
Figure 14.7 on page 369. 


Larsyn Supply Company 


3 1 1 Elmerine Avenue 
Anderson, MO 63501 
(417)555-2484 
larsynsupply.com 

August 22, 2015 

Mr. Jack Robbins, President 
Robbins Construction, Inc. 

255 Robbins Place 
Centerville, MO 65101 

Dear Mr. Robbins: 

I was very unhappy to read your letter of August 1 7 telling me about the 
failure of the Vista 500. 1 regretted most the treatment you received from 
one of my employees when you called us. 

Harry Rivers, our best technician, has already been in touch with you to 
arrange a convenient time to come out to Centerville to talk with you 
about the driver. We will of course repair it, replace it, or refund the price. 
Just let us know your wish. 

I realize that I cannot undo the damage that was done on the day that a 
piece of our equipment failed. To make up for some of the extra trouble 
and expense you incurred, let me offer you a 1 0 percent discount on your 
next purchase or service order with us, up to a $1 ,000 total discount. 

You have indeed been a good customer for many years, and I would hate 
to have this unfortunate incident spoil that relationship. Won't you give us 
another chance? Just bring in this letter when you visit us next, and we'll 
give you that 1 0 percent discount. 

Sincerely, 


Dave Larsyn, President 


FIGURE 14.8 "Good News" Adjustment Letter 
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Quality Storage Media 



2077 Highland, Burley, ID 84765 
208 * 555 * 1613 
qualstorage.com 

February 3, 2015 

Ms. Dale Devlin 
1903 Highland Avenue 
Glenn Mills, NE 69032 

Dear Ms. Devlin: 


Thank you for writing us about the external hard drive you purchased on 
January 1 1, 2015. 1 know from personal experience how frustrating it is 
when a drive fails. 

According to your letter, you used the drive to store the business plan 
for your new consulting business. When you attempted to copy that file 
to your internal hard drive, the external drive failed, and the business 
plan was lost. You have no other copy of that file. You are asking us to 
reimburse you $1,500 for the cost of re-creating that business plan from 
notes and rough drafts. 

As you know, our drives carry a lifetime guarantee covering parts and 
workmanship. We will gladly replace the defective external drive. However, 
the guarantee states that the manufacturer and the retailer will not 
assume any incidental liability. Thus we are responsible only for the retail 
value of the external drive, not for the cost of duplicating the work that 
went into making the files stored on the drive. 

However, your file might still be recoverable. A reputable data-recovery 
firm might be able to restore the data from the file at a very reasonable 
cost. To prevent such problems in the future, we always recommend that 
you back up all valuable files periodically. 

We have already sent out your new external drive by overnight delivery. It 
should arrive within the next two days. 

Please contact us if we can be of any further assistance. 

Sincerely yours, 




Paul R. Blackwood, Manager 
Customer Relations 


If you are writing a "bad news" 
adjustment letter, salvage as much 
goodwill as you can by showing 
that you have acted reasonably. In 
denying a request, explain your side 
of the matter, thus educating the 
customer about how the problem 
occurred and how to prevent it in 
the future. 

The writer does not begin by stat- 
ing that he is denying the reader's 
request. Instead, he begins politely 
by trying to form a bond with 
the reader. In trying to meet the 
customer on neutral ground, be 
careful about admitting that the 
customer is right. If you say"Weare 
sorry that the engine you purchased 
from us is defective," it will bolster 
the customer's claim if the dispute 
ends up in court. 

The writer summarizes the facts of 
the incident, as he sees them. 

The writer explains that he is unable 
to fulfill the reader's request. Notice 
that the writer never explicitly 
denies the request. It is more 
effective to explain why granting 
the request is not appropriate. Also 
notice that the writer does not 
explicitly say that the reader failed 
to make a backup copy of the plan 
and therefore the problem is her 
fault. 

The writer shifts from the bad 
news to the good news. The 
writer explains that he has already 
responded appropriately to the 
reader's request. 

The writer ends with a polite con- 
clusion. A common technique is to 
offer the reader a special discount 
on another, similar product. 


FIGURE 14.9 "Bad News" Adjustment Letter 
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Writing Memos 

Even in the age of email and microblogs, memos are likely to survive because 
sometimes writers want a slightly more formal document. Like letters, 
memos have a characteristic format, which consists of the elements shown 
in Figure 14.10. 


Write out the month instead of 
using the all-numeral format 
(6/12/12); multicultural readers 
might use a different notation for 
dates and could be confused. 


AMRO 

MEMO 

To: 

B. Pabst 

From: 

J. Alonso J^.4 

Subject: 

MIXER RECOMMENDATION FOR PHILLIPS 

Date: 

12 June 201 5 


List the names of persons receiving 
copies of the memo, either alpha- 
betically or in descending order of 
organizational rank. 


Most writers put their initials or 
signature next to the typed name 
(or at the end of the memo) to show 
that they have reviewed the memo 
and accept responsibility for it. 


INTEROFFICE 


To: 

From: 

Subject: 

Date: 


C. Cleveland c: B. Aaron 

H. Rainbow 3%. M. K. Lau 

Shipment Date of Blueprints J. Manuputra 

to Collier W. Williams 

2 October 201 5 


NORTHERN PETROLEUM COMPANY 
INTERNAL CORRESPONDENCE 


Date 

To 

From 

Subject 


January 3, 201 5 

William Weeks, Director of Operations 
Helen Cho, Chemical Engineering Dept. (}. 

Trip Report — Conference on Improved Procedures 
for Chemical Analysis Laboratory 


FIGURE 14.10 Identifying Information in a Memo 

Some organizations prefer the full names of the writer and reader; others want only the first initials 
and last names. Some prefer job titles ; others do not. If your organization does not object, include your 
job title and your reader's. The memo will then be informative for anyone who refers to it after either of 
you has moved on to a new position, as well as for others in the organization who do not know you. 


Print the second and all subsequent pages of a memo on plain paper rather 
than on letterhead. Include three items in the upper right-hand or left-hand 
corner of each subsequent page: the name of the recipient, the date of the 
memo, and the page number. See the header in Figure 14.3 on pages 364-65. 

Figure 14.11, a sample memo, is a trip report, a record of a business trip 
written after the employee returned to the office. Readers are less interested 
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Dynacol Corporation 


INTEROFFICE COMMUNICATION 

To: G. Granby, R&D 

From: P. Rabin, Technical Services 

Subject: Trip Report — Computer Dynamics, Inc. 

Date: September 21 , 201 5 

The purpose of this memo is to present my impressions of the Computer 
Dynamics technical seminar of September 1 9. The goal of the seminar was to 
introduce their new PQ-500 line of high-capacity storage drives. 

Summary 

In general, I was impressed with the technical capabilities and interface of the 
drives. Of the two models in the 500 series, I think we ought to consider the 
external drives, not the internal ones. I'd like to talk to you about this issue 
when you have a chance. 

Discussion 

Computer Dynamics offers two models in its 500 series: an internal drive and 
an external drive. Both models have the same capacity (IT of storage), and 
they both work the same way: they extend the storage capacity of a server 
by integrating an optical disk library into the file system. The concept is that 
they move files between the server's faster, but limited-capacity, storage 
devices (hard disks) and its slower, high-capacity storage devices (magneto- 
optical disks). This process, which they call data migration and demigration, is 
transparent to the user. 

For the system administrator, integrating either of the models would require 
no more than one hour. The external model would be truly portable; the user 
would not need to install any drivers, as long as his or her device is docked on 
our network. The system administrator would push the necessary drivers onto 
all the networked devices without the user having to do anything. 

Although the internal drive is convenient — it is already configured for the 
computer — I think we should consider only the external drive. Because so many 
of our employees do teleconferencing, the advantage of portability outweighs 
the disadvantage of inconvenience. The tech rep from Computer Dynamics 
walked me through the process of configuring both models. A second 
advantage of the external drive is that it can be salvaged easily when we take a 
computer out of service. 

Recommendation 

I'd like to talk to you, when you get a chance, about negotiating with Computer 
Dynamics for a quantity discount. I think we should ask McKinley and Rossiter 
to participate in the discussion. Give me a call (x3442) and we'll talk. 


The subject line is specific: the 
reader can tell at a glance that the 
memo reports on a trip to Com- 
puter Dynamics, Inc. If the subject 
line read only "Computer Dynamics, 
Inc.," the reader would not know 
what the writer was going to 
discuss about that company. 


The memo begins with a clear state- 
ment of purpose, as discussed in Ch. 
5, p. 108. 


Note that the writer has provided a 
summary, even though the memo 
is less than a page. The summary 
gives the writer an opportunity to 
convey his main request: he would 
like to meet with the reader. 


The main section of the memo 
is the discussion, which conveys 
the detailed version of the writer's 
message. Often the discussion 
begins with the background: the 
facts that readers will need to 
know to understand the memo. In 
this case, the background consists 
of a two-paragraph discussion of 
the two models in the company's 
500 series. Presumably, the reader 
already knows why the writer went 
on the trip. 

Note that the writer ends this dis- 
cussion with a conclusion, or state- 
ment of the meaning of the facts. In 
this case, the writer's conclusion is 
that the company should consider 
only the external drive. 


A recommendation is the writer's 
statement of what he would like 
the reader to do next. In this case, 
the writer would like to sit down 
with the reader to discuss how to 
proceed. 


FIGURE 14.11 Sample Memo 
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in an hour-by-hour narrative of what happened than in a carefully struc- 
tured discussion of what was important. Although writer and reader appear 
to be relatively equal in rank, the writer goes to the trouble of organizing the 
memo to make it easy to read and refer to later. 


When you write a memo, organize it so that it is easy to follow. Consider these five 

organizational elements. 

► A specific subject line. "Breast Cancer Walk" is too general. "Breast Cancer Walk 
Rescheduled to May 14" is better. 

► A clear statement of purpose. As discussed in Chapter 5 (p. 1 08), the purpose 
statement is built around a verb that clearly states what you want the readers to 
know, believe, or do. 

► A brief summary. Even if a memo fits on one page, consider including a sum- 
mary. For readers who want to read the whole memo, the summary is an advance 
organizer; for readers in a hurry, reading the summary substitutes for reading the 
whole memo. 

► Informative headings. Headings make the memo easier to read by enabling 
readers to skip sections they don't need and by helping them understand what 
each section is about. In addition, headings make the memo easier to write be- 
cause they prompt the writer to provide the kind of information readers need. 

► A prominent recommendation. Many memos end with one or more recom- 
mendations. Sometimes these recommendations take the form of action steps: 
bulleted or numbered lists of what the writer will do or what the writer would like 
others to do. Here is an example: 

Action Items: 

I would appreciate it if you would work on the following tasks and have 

your results ready for the meeting on Monday, June 9. 

• Henderson: recalculate the flow rate. 

• Smith: set up meeting with the regional EPA representative for some 
time during the week of May 1 3. 

• Falvey: ask Armitra in Houston for his advice. 


Before you write an email in the workplace, find out your organization’s 
email policies. Most companies have written policies that discuss circum- 
stances under which you may and may not use email, principles you should 
use in writing emails, and the monitoring of employee email. Figure 14.12 
shows the basic elements of an email. 





Organizing a Memo 


Writing Emails 
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. Mail To: Doc Team 


File Ed* View Actions Tools Accounts Window Help 

Send SI Caned F] Address [7J !$,, ^ 

Send Options 




Mail 


[From: ^ I [ Melissa Cartright 

To: Doc Team 

Subject: Input re Policy on Including Print Doc 



CC: | Bob Halloran o 


BC: | Cindy Belloc 


Julie, Bob, and Rajiv- 

As I mentioned at our meeting last week, I want to get your response to an idea about changing the way we 
distribute print docs with our systems. I’ll be meeting with Ann in Marketing next week and I want to be sure I 
can represent our views effectively. 

The idea is to stop including the Getting Started brochure and the User’s Guide in the box. Instead we’ll include 
a post card that customers can use to request these two docs, at no cost. Of course, the two docs will remain up 
on the site as PDFs. And we’ll still include the setup instructions on the poster. 

A recent thread on TECHWR-L on this technique suggests that it can reduce the number of docs that we need to 
print by 70-85%. That’s good, of course, in terms of print runs, as well as shipping costs. Before I run the 
numbers on cost savings, however, I want to get a sense of what you think about the idea from the perspective 
of the customer. Do you think that not including the docs will make a bad impression? Will it increase problems 
when they set up the printers? 

We won’t have final say on whether to adopt this idea, I’m afraid, but I want to make sure our voices are heard. 
After all, we know more about the customer experience than anyone else at the company. 

Please respond by email to all of us by Friday at noon. Thanks very much. 

Regards, 

Melissa 


Melissa Cartright, Senior Documentation Specialist 
Print Pro Systems 
voice: 216.555.3407 
fax: 216.555.3400 


[ Account: Mo veil Group Wise 


FIGURE 14.12 Elements of an Email 


"CC" stands for courtesy copy. All of 
your recipients will know that you 
are sending a copy to this person 
or group. 

"BC" or "Bcc" stands for blind copy 
or blind courtesy copy. None of your 
readers will know that you are send- 
ing a copy to this person or group. 

You can create a "group" for people 
whom you email frequently. 

Like a memo, an email should have 
a specific subject line. 


By naming her readers at the start, 
the writer is showing respect for 
them. 

The first paragraph of the email 
clarifies the writer's purpose. 

The second paragraph describes the 
idea. You want to be sure your read- 
ers understand the context. 

Notice that paragraphs are relatively 
brief and that the writer skips a line 
between paragraphs. 

The writer explains what she would 
like her readers to do, and she states 
a deadline. 

The writer ends politely. 

The writer has created a signature, 
which includes her contact informa- 
tion. This signature is attached 
automatically to her emails. 


A 


GUIDELINES 


Following Netiquette 


When you write email in the workplace, adhere to the following netiquette guide- 
lines. Netiquette refers to etiquette on a network. 


► Stick to business. Don't send jokes or other nonbusiness messages. 

► Don't waste bandwidth. Keep the message brief. When you reply to another 
email, don't quote long passages from it. instead, establish the context of the 
original email by paraphrasing it briefly or by including a short quotation from 


( continued ) 
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it. When you quote, delete the routing information from the top as well as the sig- 
nature block from the bottom. And make sure to send the email only to people 
who need to read it. 

► Use the appropriate level of formality. As discussed on page 360, avoid informal 
writing. 

► Write correctly. As discussed on page 361 , remember to revise, edit, and proof- 
read your emails before sending them. 

► Don't flame. To flame is to scorch a reader with scathing criticism, usually in 
response to something that person wrote in a previous message. When you are 
angry, keep your hands away from the keyboard. 

► Make your message easy on the eyes. Use uppercase and lowercase letters, and 
skip lines between paragraphs. Use uppercase letters or boldface (sparingly) for 
emphasis. 

► Don't forward a message to an online discussion forum without the writer's 
permission. Doing so is unethical and illegal; the email is the intellectual prop- 
erty of the writer or (if it was written as part of the writer's work responsibilities) 
the writer's company. 

► Don't send a message unless you have something to say. If you can add some- 
thing new, do so, but don't send a message just to be part of the conversation. 


Figure 14.13a shows an email that violates netiquette guidelines. The 
writer is a technical professional working for a microchip manufacturer. Fig- 
ure 14.13b shows a revised version of this email message. 


The writer does not dearly state his 
purpose in the subject line and the 
first paragraph. 


Using all uppercase letters gives the 
impression that the writer is yelling 
at his readers. 


The writer has not proofread. 


The writer's tone is hostile. 


With long lines and no spaces 
between paragraphs, this email is 
difficult to read. 


I To: Supers and Leads 

Subject: 

LATELY, WE HAVE BEEN MISSING LASER REPAIR FILES FOR OUR 16MEG WAFERS. 
AFTER BRIEF INVESTIGATION, I HAVE FOUND THE MAIN REASON FOR THE MISSING 
DATA. 

OCCASIONALLY, SOME OF YOU HAVE WRONGLY PROBED THE WAFERS UNDER THE 
CORRELATE STEP AND THE DATA IS THEN COPIED INTO THE NONPROD STEP USING 
THE QTR PROGRAM. THIS IS REALLY STUPID. WHEN DATE IS COPIED THIS WAY THE 
REPAIR DATA IS NOT COPIED. IT REMAINS UNDER THE CORRELATE STEP. 

TO AVOID THIS PROBLEM, FIRST PROBE THE WAFERS THE RIGHT WAY IF A 
WAFER MUST BE PROBED UNDER A DIFFERENT STEP, THE WAFER IN THE CHANGE FILE 
MUST BE RENAMED TO THE ** FORMAT. 

EDITiNG THE WAFER DATA FILE SHOULD BE USED ONLY AS A LAST RESORT, IF THIS 
^BECOMES A COMMON PROBLEM, WE COULD HAVE MORE PROBLEMS WITH 
INVALID DATA THAT THERE ARE NOW. 

SUPERS AND LEADS: PLEASE PASS THIS INFORMATION ALONG TO THOSE WHO NEED 
TO KNOW. 

ROGER VANDENHEUVAL 


a. Email that violates netiquette guidelines 

FIGURE 14.13 Netiquette 
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1 To: Supers and Leads 

1 Subject: Fix for Missing Laser Repair Files for 16MB Wafers 

The writer has edited and proofread 
the email. 

Supers and Leads: 

Lately, we have been missing laser repair files for our 16MB wafers. 

In this e-mail 1 want to briefly describe the problem and recommend a 
method for solving it. 

The subject line and first paragraph 
clearly state the writer's purpose. 

Here is what 1 think is happening. Some of the wafers have been 
probed under the correlate step; this method copies the data into the 
nonprod step and leaves the repair data uncopied. It remains under 
the correlate step. 

To prevent this problem, please use the probing method outlined in 
Spec 344-012. If a wafer must be probed using a different method, 
rename the wafer in the CHANGE file to the *.* format. Edit the wafer 
data file only as a last resort. 

I'm sending along copies of Spec 344-012. Would you please pass 
along this e-mail and the spec to all of your operators. 

Double-spacing between para- 
graphs and using short lines make 
the email easier to read. 

Roger Vandenheuval 

The writer concludes politely. 


b. Email that adheres to netiquette guidelines 

FIGURE 14.13 Netiquette ( continued ) 


Writing Microblogs 

As discussed earlier in this chapter, microblog posts are different from let- 
ters, memos, and email in that they are often extremely brief and quite infor- 
mal in tone. Usually, you do not revise microblog posts extensively. You just 
proofread and send them. 

However, the fact that microblog posts are fast and informal does not 
mean that anything goes. When you write microblog posts, you are creating 
communication that will be archived and that will reflect on you and your 
organization. In addition, anything you write is subject to the same laws and 
regulations that pertain to all other kinds of documents. Many of the guide- 
lines for following netiquette (see p. 375) apply to microblog posts as well as 
email. Take care, especially, not to flame. Become familiar with your micro- 
blog’s privacy settings, and be aware of which groups of readers may view 
and share your posts. 

The best way to understand your responsibilities when you write a micro- 
blog post at work is to study your organization’s guidelines. Sometimes, these 
guidelines are part of the organization’s guidelines for all business practices 
or all digital communication. Sometimes, they are treated separately. Figure 
14.14 shows one company’s microblogging guidelines. 
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DOCUMENT ANALYSIS ACTIVITY 


Following Netiquette in an Email Message 


This message was written 
in response to a question 
emailed to several colleagues 
by a technical communicator 
seeking advice on how to write 
meeting minutes effectively. A 
response to an email message 
should adhere to the principles 
of effective emails and proper 
netiquette. The questions below 
ask you to think about these 
principles (explained on pp. 
374-77). 

1 . How effectively has 
the writer conserved 
bandwidth? 

2 . How effectively has the 
writer stated her purpose? 

3 . How effectively has the 
writer projected a “you atti- 
tude" (explained on p. 361)? 

4 . How effectively has the 
writer made her message 
easy to read? 



© This message has not been sent. 

To... 1 1 jjensen@procom.com 

&■ I I 

Subject: i Re: meeting minutes 


«For the past several months, I have been trying to capture the meeting minutes for the McKinley 
documentation team's weekly meetings. These meetings are well attended (about 10-15 participants) 
and are fast-paced, with a number of key participants talking very fast and interrupting each other. At 
first I tried to capture these exchanges with a paper and pen. Sadly, I don't know shorthand. It was 
impossible. 

Now I use a recorder and transcribe the conversations after each meeting. Unfortunately, the 
recorder I currently use doesn't always pick up low voices but easily picks up rustling papers. The 
transcription is very time intensive: I spend a lot of time pushing the playback button. My supervisor 
keeps telling me to stop relying on the recorder and to go back to taking minutes by hand. I totally 
DISAGREE with her. 

Do any of you take minutes and, if so, do you have any suggestions for how to deal with my 
situation? Your thoughts are most welcomed. 

Jessi Jensen 

Documentation Specialist II 
ProCom, Inc. 
jjensen @ procom.com 
(619) 692-1 234» 

I always try to avoid taking minutes-it's a SECRETARY'S JOB. It's definitely not something a 
TECHNICAL COMMUNICATOR-especially a female tech communicator (we don't want to 
encourage gender stereotyping)~should be wasting time with. I think it's STUPID to transcribe 
WORD-FOR-WORD the talk that occurs in meetings. Is even 5% of the talk of value? I AGREE with 
your supervisor: you are WASTING a ton of time. 

When I can't avoid taking meeting minutes, I bring my laptop to the meeting. I try to have the meeting 
agenda already open on my word processor. Then I enter points under those headings instead of 
having to type the headings. I note meeting details (date, team name, names of attendees, etc.), 
changes to (or approval of) previous meeting's minutes, main topics of discussion, and 
decisions/action items. If I miss something or am unclear whether a decision was made, I interrupt and 
ask, "So, let me confirm that I've got this straight.” Later, I edit my notes into coherent minutes. Kelly ■ 
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Note that some of these "best 


Definition 


Microblogging Guidelines 


practices" apply only to the use of 
a public microblogging site such as 
Twitter, whereas others refer to all 
sites, public or private. 


Microblogging is social networking combined with short-message blogging. 
Author-owned content "updates" are delivered in short messages (typically 
140 characters or less in length) distributed through online and mobile 
networks to the author's "followers." 

The leading microblog is Twitter; however, there are additional microblogs 
such as Jaiku. Twitter interactions can be made via the Twitter website, or via 
mobile text messages, Instant Messaging, or desktop applications such as 
Twitterific,Twhirl, and others. Flexibility is further enhanced by the ability to 
subscribe to updates via RSS. 

Best Practices 

• Remember, Twitter is a public platform and can be indexed by search 
engines. This means that what is written can become part of your and 
Xerox's "permanent record." 

• Be yourself. Losing the trust of your followers can damage a reputation. 

• Don't create an account and have someone else post on your behalf. 

• Know that what you Tweet can be ReTweeted by others and referenced on 
other sites. Give credit to others whose message you are ReTweeting. 

• Respond in a timely fashion and be sure to always contact those reaching 
out to you. 

• Too much pro-brand messaging or marketing hype will negatively impact 
the number of followers you attract and/or keep. 

• If you decide to open an account, take the time to actively monitor your 
account and facilitate two-way conversation. 

• Don't make a professional account too personal, but don't lack personal 
touch either. 

• Avoid making your followers feel that "Big Brother" is watching. It is good 
to interact, but don't comment on every single post they make. 


FIGURE 14.14 Guidelines for Microblogging 

Used by permission of Xerox Corporation. 


If you use a microblog at work to communicate with people outside your own 
organization, such as vendors and customers, you want to use it in such a way that 
people are encouraged to like, respect, and trust you. These ten suggestions can 
help. 

► Decide on your audience and your purpose. Are you connecting with clients, 
providing customer service, helping people understand your company's goals 
and vision? You might want to have different accounts if you have several differ- 
ent audiences and purposes. 


4\ 



Representing Your Organization 
on a Microblog 


( continued ) 
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► Learn the technology. Know how to use hashtags, how to mention other users 
in your tweets, how to reply publicly and privately, how to integrate images and 
videos, and how to cross-post to your other social media accounts should you 
need to. 

► Learn the culture of the community. Listen and learn before you post. Most 
communities have a distinct culture, which influences how and when people 
post, link, and reply. For instance, in some communities, people stick close to the 
technical topic; in others, they roam more freely and include personal comments. 

► Share, don't sell. Post about incidents and developments that reinforce your 
organization's core principles, such as environmental awareness or making 
technology available around the world. Talk about leadership, teamwork, and 
cooperation. Don't try to sell products. 

► Help educate readers and solve their problems. Regardless of whether you're 
responding to individual questions and complaints or helping people under- 
stand your company's culture or goals, focus on helping people learn and solve 
problems. 

► Sound like a person. Use an informal tone. Readers are especially pleased when 
high-ranking employees show their human side, such as when the Zappos CEO 
posted, "Dropped my laptop on floor this morning. I usually drop my phone, so 
good to know I'm moving on to bigger and better things" (Hall, 2009). 

► Apologize when you make a mistake. Pepsi recently ran a marketing campaign 
about a one-calorie product in which the cartoon calorie was so lonely it was 
considering suicide. After someone complained about the ad's insensitivity, a 
Pepsi representative tweeted her (and the rest of the world) to apologize. Using 
his own name, he agreed with her that the ad was inappropriate and said he had 
taken it down (Stibell, 2011). 

► Link generously. When you want to talk about something you've learned online, 
don't paraphrase. Rather, link back to the original source. Use a URL shortener 
such as Bitly or Tiny URL so that the link won't take up too many of your 140 char- 
acters. 

► Get your facts right. Like anything online, your post is permanent. Double-check 
your facts before you post. Otherwise, you could embarrass yourself and erode 
people's trust in your professionalism. 

► Edit and proofread before you post. You should be informal, but you shouldn't 
be sloppy. It sends the wrong message. 


Writing Correspondence 
to Multicultural Readers 

For more about cultural variables, 
see Ch. 5, p. 95. 


The four types of business correspondence discussed in this chapter are used 
in countries around the world. The ways they are used, however, can differ 
significantly from the ways they are used in the United States. These differ- 
ences fall into three categories: 
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• Cultural practices. As discussed in Chapter 5, cultures differ in a number 
of ways, such as whether they focus on individuals or groups, the distance 
between power ranks, and attitudes toward uncertainty. Typically, a 
culture’s attitudes are reflected in its business communication. For 
example, in Japan, which has a high power distance — that is, people in 
top positions are treated with great respect by their subordinates — a 
reader might be addressed as “Most Esteemed Mr. Director.” Some cultural 
practices, however, are not intuitively obvious even if you understand the 
culture. For example, in Japanese business culture, it is considered rude 

to reply to an email by using the reply function in the email software; it is 
polite to begin a new email (Sasaki, 2010). 

• Language use and tone. In the United States, writers tend to use 
contractions, the first names of their readers, and other instances of 
informal language. In many other countries, this informality is potentially 
offensive. Also potentially offensive is U.S. directness. A writer from the 
United States might write, for example, that “14 percent of the products 
we received from you failed to meet the specifications.” A Korean would 
more likely write, “We were pleased to note that 86 percent of the 
products we received met the specifications.” The writer either would 
not refer to the other 14 percent (assuming that the reader would get the 
point and replace the defective products quickly) or would write, “We 
would appreciate replacement of the remaining products.” Many other 
aspects of business correspondence differ from culture to culture, such 

as preferred length, specificity, and the use of seasonal references in the 
correspondence. 

• Application choice and use. In cultures in which documents tend to be 
formal, letters might be preferred to memos, or face-to-face meetings to 
phone calls or email. In Asia, for instance, a person is more likely to walk 
down the hall to deliver a brief message in person because doing so shows 
more respect. In addition, the formal characteristics of letters, memos, 
and emails are different in different cultures. The French, for instance, 
use indented paragraphs in their letters, whereas in the United States, 
paragraphs are typically left-justified. The ordering of the information in 
the inside address and complimentary close of letters varies widely. In 
many countries, emails are structured like memos, with the “to,” “from,” 
“subject,” and “date” information added at the top, even though this 
information is already present in the routing information. 

Try to study business correspondence written by people from the culture 

you will be addressing. When possible, have important documents reviewed 

by a person from that culture before you send them. 
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WRITER'S CHECKLIST 


Letter Format 

EH Is the first page printed on letterhead stationery? (p. 364) 
EH Is the date included? (p. 364) 

EH Is the inside address complete and correct? (p. 364) 

EH Is the appropriate courtesy title used? (p. 364) 

EH If appropriate, is an attention line included? (p. 364) 

EH If appropriate, is a subject line included? (p. 364) 

EH Is the salutation appropriate? (p. 364) 

EH Is the complimentary close typed with only the first word 
capitalized? (p. 365) 

EH Is the signature legible, and is the writer's name typed 
beneath the signature? (p. 365) 

EH If appropriate, is an enclosure line included? (p. 365) 

EH If appropriate, is a copy and/or courtesy-copy line 
included? (p. 365) 

EH Is the letter typed in one of the standard formats? (p. 366) 

Types of Letters 

Does the inquiry letter 

EH explain why you chose the reader to receive the inquiry? 
(p. 367) 

EH explain why you are requesting the information and how 
you will use it? (p. 367) 

EH specify the date when you need the information? (p. 367) 
EH list the questions clearly and, if appropriate, provide 
room for the reader's responses? (p. 367) 

EH offer, if appropriate, the product of your research? 

(p. 367) 

Does the response to an inquiry letter 

□ answer the reader's questions? (p. 368) 

EH explain why, if any of the reader's questions cannot be 
answered? (p. 368) 

Does the claim letter 

EH identify specifically the unsatisfactory product or 
service? (p. 369) 

EH explain the problem(s) clearly? (p. 369) 

□ propose an adjustment? (p. 369) 

EH conclude courteously? (p. 369) 


Does the "good news" adjustment letter 

□ express your regret? (p. 370) 

EH explain the adjustment you will make? (p. 370) 

EH conclude on a positive note? (p. 370) 

Does the "bad news" adjustment letter 

□ meet the reader on neutral ground, expressing regret 
but not apologizing? (p. 371) 

LH explain why the company is not at fault? (p. 371) 

EH clearly imply that the reader's request is denied? 

(p. 371) 

EH attempt to create goodwill? (p. 371) 

Memos 

EH Does the identifying information adhere to your 
organization's standards? (p. 372) 

EH Did you include a specific subject line? (p. 373) 

EH Did you clearly state your purpose at the start of the 
memo? (p. 373) 

EH If appropriate, did you summarize your message? 

(p. 373) 

EH Did you provide appropriate background for the 
discussion? (p. 373) 

EH Did you organize the discussion clearly? (p. 374) 

EH Did you include informative headings to help your 
readers? (p. 374) 

EH Did you highlight items requiring action? (p. 374) 

Email 

EH Did you refrain from sending jokes or other nonbusiness 
messages? (p. 375) 

EH Did you keep the email as brief as possible and send it 
only to appropriate people? (p. 375) 

EH Did you use the appropriate level of formality? (p. 376) 

EH Did you write correctly? (p. 376) 

EH Did you avoid flaming? (p. 376) 

EH Did you write a specific, accurate subject line? 

(p. 376) 

EH Did you use uppercase and lowercase letters? (p. 376) 
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IID Did you skip lines between paragraphs? (p. 376) 

1 Did you check with the writer before forwarding his or 
her message? (p. 376) 


Microblogs 

I I Did you study your organization's policy on which 
microblog sites you may use and how you should use 
them? (p. 377) 


EXERCISES 


1 . You are the head of research for a biological research 
organization. Six months ago, you purchased a 
$2,000 commercial refrigerator for storing research 
samples. Recently, you suffered a loss of more than 
$600 in samples when the thermostat failed and the 
temperature in the refrigerator rose to more than 48 
degrees over the weekend. Inventing any reasonable 
details, write a claim letter to the manufacturer of the 
refrigerator. 

2. As the recipient of the claim letter described in Exercise 
1, write an adjustment letter granting the customer's 
request. 

3. You are the manager of a private swimming club. A 
member has written saying that she lost a contact 
lens (value $75) in your pool and she wants you to 
pay for a replacement. The contract that all members 
sign explicitly states that the management is not 
responsible for the loss of personal possessions. Write 
an adjustment letter denying the request. Invent any 
reasonable details. 

4. As the manager of a retail electronics store, you 
guarantee that the store will not be undersold. If 
a customer finds another retailer selling the same 
equipment at a lower price within one month of his or 
her purchase, you will refund the difference. A customer 
has written to you and enclosed an ad from another 
store showing that it is selling a router for $26.50 less 
than he paid at your store. The advertised price at the 
other store was a one-week sale that began five weeks 
after the date of his purchase. He wants a $26.50 refund. 
Inventing any reasonable details, write an adjustment 
letter denying his request. You are willing, however, to 
offer him an 8-GB USB drive worth $9.95 if he would like 
to come pick it up. 

5. TEAM EXERCISE Form small groups for this exercise 
on claim and adjustment letters. Have each member 
of your group study the following two letters. Then 


meet and discuss your reactions to the two letters. 
How effectively does the writer of the claim letter 
present his case? How effective is the adjustment 
letter? Does its writer succeed in showing that the 
company's procedures for ensuring hygiene are 
effective? Does its writer succeed in projecting a 
professional tone? Write a memo to your instructor 
discussing the two letters. Attach a revision of the 
adjustment letter to the memo. 


Seth Reeves 
19 Lowry's Lane 
Morgan, TN 30610 

April 13, 2015 

Sea-TastyTuna 
Route 1 1 3 

Lynchburg, TN 30563 
Gentlemen: 

I've been buying your tuna fish for years, and up to now it's 
been OK. 

But this morning I opened a can to make myself a sandwich. 
What do you think was staring me in the face? A fly. That's 
right, a housefly. That's him you see taped to the bottom of 
this letter. 

What are you going to do about this? 

Yours very truly, 
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Sea-Tasty Tuna 
Route 1 13 

Lynchburg, TN 30563 
www.seatastytuna.com 

April 20, 2015 

Mr. Seth Reeves 
19 Lowry's Lane 
Morgan, TN 30610 

Dear Mr. Reeves: 

We were very sorry to learn that you found a fly in your tuna fish. 

Here at Sea-Tasty we are very careful about hygiene at our 
plant. The tuna are scrubbed thoroughly as soon as we 
receive them. After they are processed, they are inspected 
visually at three different points. Before we pack them, we 
rinse and sterilize the cans to ensure that no foreign material 
is sealed in them. 

Because of these stringent controls, we really don't see how 
you could have found a fly in the can. Nevertheless, we are 
enclosing coupons good for two cans of Sea-Tasty tuna. 

We hope this letter restores your confidence in us. 

Truly yours, 


6. Louise and Paul work for the same manufacturing 
company. Louise, a senior engineer, is chairing a 
committee to investigate ways to improve the hiring 
process at the company. Paul, a technical editor, also 
serves on the committee. The excerpts quoted in 
Louise's email are from Paul's email to all members of 
the committee in response to Louise's request that 
members describe their approach to evaluating job- 
application materials. How would you revise Louise's 
email to make it more effective? 


To: Paul 
From: Louise 

Sometimes I just have to wonder what you're thinking, Paul. 

>Of course, it's not possible to expect perfect resumes. But I 
>have to screen them, and last year I had to read over 200. I'm 
>not looking for perfection, but as soon as I spot an error I 
>make a mental note of it and, when I hit a second and 
>then a third error I can't really concentrate on the writer's 
credentials. 

Listen, Paul, you might be a sharp editor, but the rest of us 
have a different responsibility: to make the products and 
move them out as soon as possible. We don't have the 
luxury of studying documents to see if we can find errors. 

I suggest you concentrate on what you were hired to do, 
without imposing your "standards" on the rest of us. 

>From my point of view, an error can include a 
>misused tradmark. 

Misusing a "tradmark," Paul? Is that Error Number 1 ? 


7. Because students use email to communicate with other 
group members when they write collaboratively, your 
college or university would like to create a one-page 
handout on how to use email responsibly. Using a 
search engine, find three or four netiquette guides on 
the Internet that focus on email. Study these guides 
and write a one-page student guide to using email 
to communicate with other students. Somewhere in 
the guide, be sure to list the sites you studied, so that 
students can visit them for further information about 
netiquette. 


>g| CASE 1 4: Setting Up and Maintaining a Professional Microblog Account 



As the editor-in-chief of your college newspaper, you have recently been granted 
permission to create a Twitter account. The newspaper's faculty advisor has requested that, 
before you set up the account, you develop a statement of audience and purpose based 
on your school's own social-media policy statement and statements from other schools, 
newspapers, and organizations. To begin putting together a bibliography to guide your 
research and craft your statement, go to "Cases" under "Additional Resources" in Ch. 14: 
macmillanhighered.com/launchpad/techcomm1 1 e. 
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GETTING HIRED has always involved writing. Whether you apply online 
through a company's website, reply to a post on Linkedln, or send a formal letter 
and resume through the mail, you will use words to make the case that the 
organization should offer you a position. 

You will probably make that case quite a few times. According to the U.S. 
Department of Labor (201 2), the typical American worker holds more than 1 1 
different jobs while he or she is between the ages of 1 8 and 40. Obviously, most 
of those jobs don't last long. Even when American workers begin a new job 
between the ages of 40 and 46, a third of those workers will no longer be with 
that company at the end of one year, and two-thirds will no longer be there in five 
years. 

For most of you, looking for professional work is the first nonacademic test of 
your technical-communication skills. And it's an important test. Kyle Wiens, CEO 
of two tech companies, iFixit and Dozuki, requires all new employees to pass a 
writing test. His reason? "If it takes someone more than 20 years to notice how to 
properly use 'it's,' then that's not a learning curve I'm comfortable with" (Bowers, 
2013). 


Understanding the Job-Application Process 

Preparing job-application materials requires weeks and months, not days, 
and there is no way to cut corners. The Focus on Process box (on page 387) 
presents an overview of the process. 


Establishing Your Professional Brand 

One way to look at the process of looking for work is to keep in mind that, 
except for those times when you don’t want to be in the workforce, you 
are always looking for work. That doesn’t literally mean you’re always 
applying for jobs; it means you’re always open to the possibility that a 
job that interests you will come along. In other words, you are a passive 
applicant. When employers have an opening, they seek out the best 
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FOCUS ON PROCESS 


In writing job-application materials, pay special attention to these steps in the writing 
process. 


PLANNING 


Learn as much as you can about the organizations to which you 
will apply. See Chapter 6 for help with research. 


DRAFTING 


Decide whether to write a chronological or skills resume, and 
use traditional sections and headings. In your job-application 
letter, elaborate on key points from your resume. 



You want these documents to be perfect. Ask several people 
to review them. See the Writer's Checklist on page 41 6. 


candidates — regardless of whether those candidates are looking actively 
or passively (Cohen, 2013). 

Being a successful job seeker requires a particular frame of mind. Think of 
yourself not as a student at this college or an employee of that company but 
rather as a professional with a brand to establish and maintain. For instance, 
say your name is Amber Cunningham, and you work as a human-resources 
officer for Apple. Don’t think of yourself as an Apple human-resources officer. 
Instead, think of yourself as Amber Cunningham, a human-resources spe- 
cialist who has worked for several companies (including Apple) and who has 
a number of marketable skills and a substantial record of accomplishments. 
Your professional brand (sometimes referred to as a “personal brand”) is Amber 
Cunningham. Your challenge is to attract employers successfully — even if 
you’re happy with your current position at Apple and are not looking to 
change jobs. 

To present your professional brand successfully, you need to understand 
what employers are looking for, and then you need to craft the materials that 
will present that brand to the world. 

UNDERSTANDING WHAT EMPLOYERS WANT 

There is really no mystery about what employers want in an employee. 

Across all fields, employers want a person who is honest, hard-working, tech- 
nically competent, skilled at solving problems, able to work effectively alone 
and in teams, willing to share information with others, and eager to keep 
learning. 

You need to find the evidence that you can use to display these qualities. 
Begin by thinking about everything you have done throughout your college 
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career (courses, projects, service-learning experiences, organizations, leader- 
ship roles) and your professional career (job responsibilities, supervision of 
others, accomplishments, awards). And don’t forget your volunteer activi- 
ties; through these activities, many people acquire what are called transfer- 
able skills — skills that are useful or even necessary in seemingly unrelated 
jobs. For instance, volunteering for Habitat for Humanity says something 
important not only about your character but also about your ability to work 
effectively in a team and to solve problems. Even if you will never swing a 
hammer on the job, you will want to refer to this experience. Make a list — a 
long list — of your experiences, characteristics, skills, and accomplishments 
that will furnish the kinds of evidence that you can use in establishing your 
professional brand. 


Follow these six guidelines in developing your professional brand. 

► Research what others have done. What kinds of information do they present 
about themselves online? On which social-media sites are they active? What 
kinds of comments and questions do they post? How do they reply to what oth- 
ers have posted? 

► Tell the truth. Statistics about how many people lie and exaggerate in describing 
themselves in the job search vary, but it is probably between a third and a half. 
Companies search online themselves or hire investigators to verify the informa- 
tion you provide about yourself, to see if you are honest. 

► Communicate professionally. Show that you can write clearly and correctly, and 
remember that it is inappropriate (and in some cases illegal) to divulge trade 
secrets or personal information about colleagues. 

► Describe your job skills. Employers want to see that you have the technical skills 
that the job requires. They look for degrees, certifications, speeches and publica- 
tions, and descriptions of what you do in your present position and have done in 
previous positions. 

► Focus on problem-solving and accomplishments. The most compelling evi- 
dence that you would be a good hire is a solid record of identifying problems 
and devising solutions that met customers' needs, reduced costs, increased 
revenues, improved safety, and reduced environmental impact. Numbers tell the 
story: try to present your accomplishments as quantifiable data. 

► Participate actively online. One way to show you are a professional who would 
generously and appropriately share information and work well in a team is to 
display those characteristics online. Participate professionally through sites such 
as Linkedln, Facebook, and Twitter. 


4 \ 



Building the Foundation of Your 
Professional Brand 
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CRAFTING YOUR PROFESSIONAL BRAND 

With your long list of characteristics, experiences, skills, and accomplish- 
ments in hand, it’s time to start creating the materials — primarily online 
materials — that will display your professional brand. 


4 \ 


GUIDELINES 


Presenting Your Professional Brand 


The following six guidelines can help you display your professional brand. 


► Create a strong online presence. The best online presence is your own web- 
site, which functions as your online headquarters. All your other online activi- 
ties will link back to this one site, the only site on the Internet that is all about 
you. Register a site and try to name it yourname.com (you will be required 
to pay a small fee to secure the domain name). If you aren't experienced 
designing and creating sites, try a drag-and-drop site builder like Weebly or 
Squarespace, or use a template from a free blogging site such as WordPress. 
Upload to your site everything you want potential employers to see: contact 
information, a professional history, work samples, documents, and links to your 
accounts on social-media sites. If you don't have a website, take advantage of 
all the features on Linkedln. 


► Participate on Linkedln. Linkedln is the major social-media site used by 
employers to find employees. Set up a Linkedln account and create a profile 
that includes the keywords that will attract potential employers. Rather than 
calling yourself a "programmer at ADP," which describes your current situation, 
call yourself"an experienced programmer in various programming languages 
(Java, C, C ++ , and PHP) and scripting languages (JavaScript, Perl, WSH, and UNIX 
shells) who understands interactive web pages and web-based applications, 
including JavaServer Pages (JSP), Java servlets, Active Server Pages (ASP), and 
ActiveX controls." Including keywords makes it easier for potential employers 
to find you when they search for employees. In addition, remember to list spe- 
cific skills in the "Skills and Abilities" section of your profile. Potential employers 
searching for specific skills can then locate you more easily, and colleagues 
who know your work can endorse you for various skills. And don't merely 

set up an account — participate actively on Linkedln; when you read a good 
article or see a useful video, link to it so others can find it. Participate in forum 
discussions. Make connections and endorse people who you know have good 
qualifications. 

► Participate on Facebook. You probably already have a Facebook account and 
use Facebook's Timeline feature. Within your account, you also have the option of 
creating separate Pages for specific interests. Create a public Facebook Page and 
use it only for professional activities. Share information that will be interesting 
and useful to other professionals. 

► Participate on Twitter. Follow influential people in your industry on Twitter to see 
the kinds of activities, conferences, and publications that interest them. Com- 
ment on and retweet useful tweets, link to the best items you see in the media, 
and reply when others send you messages. 


To watch a tutorial on crafting 
ulcJ your professional brand, go to 
Ch. 15 > Additional Resources > 
Tutorials: macmillanhighered.com 
/launchpad/techcomml 1e. 


( continued ) 
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► Create a business card. Having a business card if you're a student might 
seem odd, but a card is the best way to direct people to your website when 
you meet them in person. Your card should have your contact information, 
a few phrases highlighting your skills, and the URL of your website. Some 
people add a QR code (a Quick Response code, the square barcode that 
smart phones can read) to allow others to link to their websites instantly. 
(Search for"QR code generator" to find free sites that will help you generate a 
QR code.) 

► Practice an "elevator pitch." An elevator pitch is a brief oral summary of your 
credentials. At less than 20 seconds long, it's brief enough that you can say it if 
you find yourself in an elevator with a potential employer. After the pitch, you 
hand the person your business card, which contains all the information he or she 
needs to get to your website, which links to everything else you want that person 
to see about you. 


In making their job offers, employers today use the information they learn 
about potential new employees on the Internet. According to a 2012 study 
commissioned by CareerBuilder of more than 2,000 hiring managers, 40 
percent of companies research job applicants on social media (Balderrama, 
2012). The good news: 19 percent of those companies report that they found 
positive information that motivated them to seek out an applicant. The bad 
news: 43 percent found information that made them reject an applicant. (The 
percentage of companies reporting that they reject an applicant for unprofes- 
sional online information is growing: from 34 percent in 2012 to 43 percent 
in 2013. This statistic suggests that more people are posting unprofessional 
content, companies are looking more closely, or both.) 

According to Balderrama, the employers who rejected applicants cited the 
following six problems most often: 

1. Provocative or unprofessional photos or text (49 percent of employers who 
mentioned problems mentioned this one) 

2. Photos or text showing drug or alcohol use (45 percent) 

3. Poor writing (35 percent) 

4. Negative comments about current or former employers (33 percent) 

5. Discriminatory comments about race, gender, or religion (28 percent) 

6. Lies about the candidate’s credentials (22 percent) 

Start by searching online for your own name. Look at what potential 
employers will see and ask yourself whether your online personal brand is 
what you want to display. If it isn’t, start to change it. 
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WRITING HONEST JOB-APPLICATION MATERIALS 

Many resumes contain lies or exaggerations. Job applicants say they attended colleges they 
didn't and were awarded degrees they weren't, give themselves inflated job titles, say they 
were laid off when they were really fired for poor performance, and inflate their accomplish- 
ments. A CareerBuilder survey found that 38 percent of employees have embellished their 
job responsibilities at some point, and 18 percent have lied about their skills (Lorenz, 2012). 
Economist Steven D. Levitt, co-author of Freakonomics, concludes that more than 50 percent 
of job applicants lie on their resumes (Isaacs, 201 2). 

Companies take this problem seriously. They hire agencies that verify an applicant's education 
and employment history and check for a criminal record. They do their own research online. 
They phone people whose names the candidate has provided. If they find any discrepancies, 
they do not offer the candidate a position. If the person is already working for the company 
when discrepancies arise, they fire the employee. 


Planning the Job Search 

Once you have constructed your personal brand online — a process that can 
take weeks or months — you can start to plan the job search. Planning calls 
for thinking about the type of work you want, learning about employers, and 
preparing the materials you will need. 

• Do a self-inventory. Before you can start thinking of where you want to 
work, you need to answer some questions about yourself: 

— What are your strengths and weaknesses? Are your skills primarily 
technical? Do you work best with others or on your own? 

— What subjects do you like? Think about what you have liked or disliked 
about your jobs and college courses. 

— What kind of organization would you like to work for? For-profit or 
nonprofit? Government or private industry? Small or large? Startup or 
established? 

— What are your geographical preferences? If you are free to relocate, where 
would you like to live? How do you feel about commuting? 

• Learn about potential employers. Once you’ve identified a company 
of interest — maybe because you have seen an ad for a position, know 
someone who works there, or have always thought about working there — 
start learning about the company by studying its website. But don’t stop 
there. Conduct informational interviews with people who have worked 
there or who know people who have; ask your professors if they can help 
you identify people to interview. Search the company’s name; the results 
will point you to articles in newspapers and magazines, as well as to blogs, 
discussion boards, and podcasts. Search for the company on Linkedln. 
Many companies use Linkedln as a hiring portal. Figure 15.1 shows a 


For more about interviewing, see 
Ch. 6, p. 136. 
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FIGURE 15.1 One 
Agency's Portal 
on Linkedln 

Source: Centers for Disease Control and 
Prevention, 2014: https://www.linkedin 
.com/company/1 57336. 


Many companies and other orga- 
nizations use Linkedln as a hiring 
portal. Atypical portal includes 
descriptions and videos about 
the organization, lists of all open 
positions (and links to the organiza- 
tion website, where you can apply 
online), and profiles of employees. 
Because organizations want to 
attract the best candidates, they 
put real effort into presenting the 
information you will need to decide 
whether to apply. 



portion of the Linkedln portal for the Centers for Disease Control and 
Prevention. Learn about the organization through other means as well: 

— Attend job fairs. Your college and your community probably hold job 
fairs, where employers provide information about their organizations. 
Sometimes, a single organization will hold a job fair to find qualified 
candidates for a wide variety of jobs. 

— Find out about trends in your field. Read the Occupational Outlook 
Handbook, published by the U.S. Department of Labor, for information 
about your field and related fields. Talk with professors and with the 
staff at your job-placement office. 

• Prepare a resume and (perhaps) a job-application letter (a cover letter). You 

will need a resume, a one- or two-page document that describes your most 
important credentials. In most cases, you will upload a resume to a job 
board such as Monster or to a company’s website; in some cases, you enter 
the information on a company’s web-based form. Some companies also 
request a job-application letter. Start planning early by obtaining materials 
from the career-placement office at your college. Talk with friends who have 
gone through the process successfully; study their application materials. 
Read books and visit websites about different aspects of the job search. 

• Put your portfolio items online. A portfolio is a collection of your best 
work, including your resume, letters of recommendation, transcripts 
and professional certifications, and reports, papers, websites, slides of 
oral presentations, and other types of documents you have written or 





Understanding Four Major Ways To Look for a Position 


15 


393 


created as a student or an employee. You should put your portfolio on your 
website and other online locations, such as your Linkedln account. The 
more items you have online, the more likely it is your name will appear 
when a potential employer searches for applicants. 

If you wish to apply for a position in another country, keep in mind that 
the conventions of the process vary — sometimes quite a bit. You will need to 
adapt your resume and letter to the expectations of employers in the country 
in which you would like to work. For instance, resumes in the United States 
do not include information such as the writer’s height, weight, date of birth, 
and marital status; federal legislation prohibits organizations from asking 
for this information. In some other countries, however, personal information 
is expected on a resume. Consult one of the following sources for advice on 
drafting resumes when applying for international positions: 

• Goinglobal.com: www.goinglobal.com 

• Monster Global Gateway: www.monster.com/geo/siteselection.aspx 

• OverseasJobs.com: www.overseasjobs.com 

• The Riley Guide: International Job Opportunities: Resources Covering 
Multiple Countries and/or Regions: www.rileyguide.com/internat.html 

Understanding Four Major 
Ways To Look for a Position 

Once you have done your planning, you can start to look for a position. There 
are four major ways to find a job. 

• Through an organization's website. Most organizations list their job 
offerings in a careers section on their websites and explain how to apply. If 
you are interested in a particular organization, start with its own site. 

• Through a job board on the Internet. Job boards are sites sponsored by federal 
agencies, Internet service providers, and private organizations. Some sites 
merely list positions; you respond to such listings by email. Other sites let 
you upload your resume electronically, so that employers can get in touch 
with you. Some job boards offer resources on how to prepare job-application 
materials; others do not. Among the biggest job boards are the following: 

— AfterCollege 

— CareerBuilder 

— CareerMag 

— CareerOneStop (sponsored by the U.S. Department of Labor) 

— Indeed.com (a metasearch engine for job seekers) 

— Monster 

One caution about using job boards: once you upload your resume to an 
Internet site, you probably have lost control of it. Here are four questions 
to consider before you post to a job board: 
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— Who has access to your resume? You might want to remove your home 
address and phone number from it if anyone can view it. 

— How will you know if an employer requests your resume? Will you be 
notified by the job board? 

— Can your current employer see your resume? If your employer discovers that 
you are looking for a new job, your current position could be in jeopardy. 

— Can you update your resume at no cost? Some job boards charge you 
each time you update your resume. 

• Through your network. A relative or an acquaintance can exert influence 
to help you get a job, or at least point out a new position. Other good 
contacts include past employers and professors. Also consider becoming 
active in the student chapter of a professional organization in your field, 
through which you can meet professionals in your local area. Many 
people use Twitter, Facebook, and — in particular — Linkedln to connect 
with their contacts, as well as to try to identify hiring officers and other 
professionals who can help them apply. Figure 15.2 shows an excerpt from 
one professional’s Linkedln profile. 


Everything in this excerpt from 
Joseph Cauteruccio's Linkedln 
profile makes the argument that 
he is talented, hard-working, and 
ambitious. 


Although the photograph was not 
taken by a professional, Joseph 
dressed professionally and looks as 
if he's eager to get into the office 
and get to work. 


The summary statement includes 
a paragraph describing his major 
responsibilities and a summary of 
his educational credentials. Note 
that Joseph also includes a number 
of keywords categorized under 
"Specialties" and "Programming 
Languages." These keywords will 
help potential employers locate his 
profile more easily. 



Joseph Cauteruccio, Jr. 

Senior Data Scientist, Strategy & Analysis at DigitasLBi 

Boston, Massachusetts Marketing and Advertising 

Current DigitasLBi 

Previous Dtgitas. Industrial Economics. State Street Corporation 
Education Yale University 


Improve your profile 


444 

connections 


□ 


www.linkedin com/in/joecautefucciojr/ 


M Contact Info 


Background 



Summary 


Senior Data Scientist on the Advanced Analytics team at DigitasLBi, a global marketing and technology 
agency. Responsible for developing and deploying machine learning algorithms that optimize the efficiency 
of marketing campaigns while directly managing client relationships and deliverables. 


BA in Economics from Bates College. M A in Statistics from Yale University. 
Specialties: Machine Learning, Statistical Analysis, Data Mining, Process Automation 


Programming Languages R, Python. SAS, SQL, FORTRAN (77, 95), Shell Scripting (BASH/KSH) Hive, 
Pig, C, C++, MatLab 

I routinely blog about data science issues, techniques, and solutions and post examples of projects in 
progress on my Web site: www joecjr.com. 


FIGURE 15.2 Excerpts from a Professional's Linkedln Profile 

Reprinted by permission of Joseph Cauteruccio. Image Credit: © 2014 Macmillan, Photo by Regina Tavani. 






15 


395 


Experience 


Senior Data Scientist, Strategy & Analysis - Advanced Analytics 

DigitasLBi 

July 2012 - Present (1 year 8 months) | Greater Boston Area 

Proven track record for improving the efficiency of marketing campaigns through the design and 
deployment of custom analytics solutions Managerial responsibilities include helping to establish practice 
area methodologies, delegation of project work, management of deadlines and workflow, production and 
presentation of client deliverables, and training of junior staff. 

Design, manage, and execute projects including: 

♦ Propensity and response models 

♦ Advanced customer base and prospect segmentations 

♦ Attribution analysis 

♦ Customer CLTV estimation 

♦ Mixed media and cross-channel models 

♦ Model scoring and implementation 

♦ Process automation 

♦ Dashboard development and data visualization 

♦ Prediction using social data (Twitter, Facebook) 

♦ High value site behavior analysis 

♦ Recommendation systems 

Methods utilized include: 

♦ Regression Analysis (Multiple variants of Logistic. OLS, Poisson, and Beta) 

♦ Cluster Analysis 

♦ Factor Analysis 

♦ Other Non-parametric methods 

♦ Analysis of stochastic processes through multiple methods 

♦ Natural Language Processing 

♦ Bayesian Inference 

♦ Support Vector Machines and other kernel classification methods 
- 1 project 

Cookie data processing system for Attribution 

The process of collecting user level cookie data is a crucial piece to any attribution system Most 
daily impression flies are 20gb or more We built a dlstnbuted system leveraging AWS's EMR 
offering lo process our cookie files and run the model View; 


The description of Joseph's cur- 
rent position is unusually full, 
with details about his managerial 
responsibilities, specific types of 
projects he's completed, and meth- 
odologies he's employed to do so. 
All of this detail not only increases 
his chances of attracting potential 
employers but also makes clear that 
he loves his job and has energy to 
burn. You get the clear impression 
he'll be the first one in the office 
in the morning and the last one to 
leave at night. 


^ Skills & Endorsements 


Top Skills 


H SAS 
Q Analytics 
Statistics 
] R 


□ 

C3 

Cl 

B 

B 


Data Analysis 
Predictive Analytics 
Segmentation 
Data Mining 
Quantitative Analytics 
Microsoft Excel 


Joseph also knows about 

^ SQL Statistical Modeling Q Predictive Modeling Q VBA 

Q PowerPoint Q Econometrics Q Quantitative Analysis Q Python 
Q Analysis ^ Stata i | Logistic Regression Q Linear Regression 
L Database Marketing Q Data Visualization ! £ Shell Scripting See 20* > 


Joseph also listed a number of spe- 
cific skills in the "Skills & Endorse- 
ments" section of his profile. Many 
Linkedln users have endorsed his 
skills, not only affirming Joseph's 
abilities but also suggesting that 
he is an active Linkedln user who 
probably endorses his colleagues, 
as is appropriate, in return. 

Joseph also follows a number of 
Linkedln influencers and companies 
within his industry, signaling to 
potential employers his dedica- 
tion to his field and desire to grow 
professionally. 
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• Through a college or university placement office or professional placement 
bureau. College and university placement offices bring companies and 
students together. Student resumes are made available to representatives 
of business, government, and industry, who arrange on-campus 
interviews. Students who do well in the campus interviews are then 
invited by the representatives to visit the organization for a tour and 
another interview. A professional placement bureau offers essentially 
the same service but charges a fee (payable by either the employer or the 
person who is hired for a job). Placement bureaus cater primarily to more- 
advanced professionals who are changing jobs. 


In 2013, 77 percent of employers used social media to recruit. Among those employ- 
ers, 94 percent said they used Linkedln (Society for Human Resource Management, 
201 3). The following five guidelines can help you take advantage of the employment 
features on the world's most influential networking site for professionals. 

► Use the profile section fully. The profile section includes information from your 
resume, but unlike a resume, which needs to be concise and contains only words, 
the profile section can include any kind of digital file, such as presentation slides 
or videos. Describe your education and professional jobs in detail; remember that 
the keywords in your descriptions will enable potential employers to find you as 
they search for employees. If you add "skills" to your profile, others have an op- 
portunity to "endorse" those skills, adding credibility to your profile. 

► Include a picture. A picture increases by sevenfold the chances that a reader will 
read your profile (Halzack, 2013). 

► Post updates. Post information about interesting articles you have read, confer- 
ences you are attending, and other professional activities. Be generous in prais- 
ing co-workers and others you follow on the Internet. Mention your volunteer 
activities. Nicole Williams, a career expert at Linkedln, writes that posting an 
update once a week makes you 1 0 times more likely to have your profile viewed 
by a hiring manager (Halzack, 2013). 

► Write unique invitation requests. You can ask one of your connections to intro- 
duce you to someone who is not one of your connections. In doing so, explain 
why you want to be introduced ("I plan to relocate to Bill's city later this year and 
want to describe the services I offer"), give your connection the opportunity to 
say no gracefully ("Would you be willing to help me make this introduction? If 
not, I understand"), and thank your connection ("I really appreciate your taking 
the time to consider my request"). 

► Write unique invitations to connect. When you want to connect with another 
Linkedln member, especially one whom you do not know well in person, avoid 
the template invitation, "I'd like to add you to my professional network." Explain 
how you know the other person: "As a fellow Aggie who's admired your com- 
pany's strategy for some time, I'd like to connect." 


4 \ 



Using Linkedln's Employment Features 
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Writing Resumes 

Although you will present your credentials on Linkedln and other sites, you 
will also need to create a resume, which you will upload to a job board or a 
company’s website, email to the company, or paste into a web-based form. 

Many students wonder whether to write their resumes themselves or use 
a resume-preparation agency. It is best to write your own resume, for three 
reasons: 

• You know yourself better than anyone else does. No matter how 
professional the work of a resume-preparation agency is, you can do a 
better job communicating important information about yourself. 

• Employment officers know the style of the local agencies. Readers who 
recognize that you did not write your own resume might wonder whether 
you are hiding any deficiencies. 

• If you write your own resume, you will be more likely to adapt it to different 
situations. You are unlikely to return to a resume-preparation agency and 
pay an additional fee to make a minor revision. 

Because most companies use resume-application software to scan resumes 
into databases and search for keywords, a good resume includes the right key- 
words. Only after a resume has made it through that initial electronic pass will 
it be read by a person. Resume consultant Ramsey Penegar puts it this way: 

“If your resume doesn’t have the keywords that match their job requirements, 
your resume may hit the ‘no’ pile early in the process” (Auerbach, 2012). 

The best way to be sure you have the appropriate keywords in your 
resume is to study the job description in the actual job posting you want to 
respond to. Then find ten other ads for similar positions and identify the 
terms that come up frequently. Think in terms of job titles, names of prod- 
ucts, companies, technologies, and professional organizations. For instance, 
if the job is to develop web pages, you will likely see many references to “web 
page,” “Internet,” “XHTML,” “HTML5,” “Java,” “W3C,” and “CSS.” Also include 
keywords that refer to your communication skills, such as “public speaking,” 
“oral communication,” and “communication skills.” 

But don’t just list the keywords. Instead, integrate them into sentences 
about your skills and accomplishments. For instance, a computer-science 
student might write, “Wrote applications for migrating data between systems/ 
databases using C#, XML, and Excel Macros.” A chemical engineer might write, 
“Worked with polymers, mixing and de-gassing polydimethylsiloxane.” 

How long should a resume be? It should be long enough to include all 
pertinent information but not so long that it bores or irritates the reader. 
Although some hiring consultants have guidelines (such as that a student’s 
resume should be no longer than one page, or that applicants who are vice 
presidents at companies can write two-page resumes), the consensus is 
that length is unimportant. If an applicant has more experience, the resume 
will be longer; if an applicant has less experience, it will be shorter. If all 
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the information in the resume helps make the case that the applicant is an 
excellent fit for the position, it’s the right length. 

The information that goes into a resume is commonly ordered either chron- 
ologically or by skills. In a chronological resume, you use time as the organizing 
pattern for each section, including education and experience, and discuss your 
responsibilities for each job you have held. In a skills resume (sometimes called 
afunctional resume ), you merely list your previous jobs but include a skills sec- 
tion in which you describe your talents, skills, and achievements. 

A chronological resume focuses on the record of employment, giving 
an applicant the opportunity to describe the duties and accomplishments 
related to each job. The skills resume highlights the skills (such as supervis- 
ing others, managing a large department, reducing production costs) that the 
candidate demonstrated at several different companies. The skills resume is 
a popular choice for applicants who have a gap in their employment history, 
who are re-entering the workforce, or who have changed jobs frequently. 

In both types of resume, you use reverse chronology; that is, you present 
the most recent jobs and degrees first, to emphasize them. 


ELEMENTS OF THE CHRONOLOGICAL RESUME 

Most chronological resumes have five basic elements: identifying informa- 
tion, summary of qualifications, education, employment history, and inter- 
ests and activities. Sometimes writers include a sixth section: references. In 
filling in these basic sections, remember that you want to include the key- 
words that will attract employers. 

Identifying Information If you are submitting your resume directly to a 
company, include your full name, address, phone number, and email address. 
Use your complete address, including the zip code. If your address during the 
academic year differs from your home address, list both and identify them 
clearly. An employer might call during an academic holiday to arrange an 
interview. 

However, if you are posting your resume to an Internet job board, where it 
can be seen by anyone, you will be more vulnerable to scammers, spammers, 
and identity thieves. Don’t include a mailing address or phone number, and 
use an email address that does not identify you. 

Summary Statement After the identifying information, add a summary 
statement, a brief paragraph that highlights three or four important skills or 
accomplishments. For example: 

Summary 

Six years' experience creating testing documentation to qualify production programs 
that run on Automated Test and Handling Equipment. Four years' experience running 
QA tests on software, hardware, and semiconductor products. Bilingual English and 
Italian. Secret security clearance. 
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Education If you are a student or a recent graduate, place the educa- 
tion section next. If you have substantial professional experience, place the 

employment-history section before the education section. 

Include at least the following information in the education section: 

• Your degree. After the degree abbreviation (such as BS, BA, AA, or MS), list 
your academic major (and, if you have one, your minor) — for example, “BS 
in Materials Engineering, minor in General Business.” 

• The institution. Identify the institution by its full name: “Louisiana State 
University,” not “LSU.” 

• The location of the institution. Include the city and state. 

• The date of graduation. If your degree has not yet been granted, add 
“Anticipated date of graduation” or a similar phrase. 

• Information about other schools you attended. List any other institutions 
you attended beyond high school, even those from which you did not earn 
a degree. The description for other institutions should include the same 
information as in the main listing. Arrange entries in reverse chronological 
order: that is, list first the school you attended most recently. 


The following four guidelines can help you develop the education section of your 

resume. 

► List your grade-point average. If your average is significantly above the median 
for the graduating class, list it. Or list your average in your major courses, or all your 
courses in the last two years. Calculate it however you wish, but be honest and clear. 

► Compile a list of courses. Include courses that will interest an employer, such as ad- 
vanced courses in your major or courses in technical communication, public speak- 
ing, or organizational communication. For example, a list of business courses on an 
engineer's resume might show special knowledge and skills. But don't bother list- 
ing required courses; everyone else in your major took the same courses. Include 
the substantive titles of listed courses. Employers won't know what "Chemistry 450" 
is; call it by its official title: "Chemistry 450. Organic Chemistry." 

► Describe a special accomplishment. If you completed a special senior design 
or research project, present the title and objective of the project, any special or 
advanced techniques or equipment you used, and, if you know them, the major 
results:"A Study of Shape Memory Alloys in Fabricating Actuators for Underwa- 
ter Biomimetic Applications — a senior design project to simulate the swimming 
styles and anatomy of fish." A project description makes you seem more like a 
professional: someone who designs and carries out projects. 

► List honors and awards you received. Scholarships, internships, and academic 
awards suggest exceptional ability. If you have received a number of such hon- 
ors, or some that were not exclusively academic, you might list them separately 
(in a section called "Honors" or "Awards") rather than in the education section. 
Decide where this information will make the best impression. 


A 
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The education section is the easiest part of the resume to adapt in apply- 
ing for different positions. For example, a student majoring in electrical engi- 
neering who is applying for a position requiring strong communication skills 
can emphasize communication courses in one version of the resume and 
advanced electrical engineering courses in another version. As you compose 
the education section, emphasize those aspects of your background that 
meet the requirements for the particular job. 

Employment History Present at least the basic information about each 
job you have held: the dates of employment, the organization’s name and 
location, and your position or title. Then add carefully selected details. 
Readers want to know what you did and accomplished. Provide at least a 
two- to three-line description for each position. For particularly important 
or relevant jobs, write more, focusing on one or more of the following 
factors: 

• Skills. What technical skills did you use on the job? 

• Equipment. What equipment did you operate or oversee? In 
particular, mention computer equipment or software with which you 
are familiar. 

• Money. How much money were you responsible for? Even if you 
considered your data-entry position fairly easy, the fact that the 
organization grossed, say, $2 million a year shows that the position 
involved real responsibility. 

• Documents. What important documents did you write or assist in writing, 
such as brochures, reports, manuals, proposals, or websites? 

• Personnel. How many people did you supervise? 

• Clients. What kinds of clients, and how many, did you do business with in 
representing your organization? 

Whenever possible, emphasize accomplishments. If you reorganized the 
shifts of the weekend employees you supervised, state the results: 

Reorganized the weekend shift, resulting in a cost savings of more than $3,000 per 
year. 

Wrote and produced (with Adobe InDesign) a 56-page parts catalog that is still 
used by the company and that increased our phone inquiries by more than 
25 percent. 

For more about using strong verbs, 
seeCh. 10, p.226. 


When you describe positions, functions, or responsibilities, use the 
active voice (“supervised three workers”) rather than the passive voice 
(“three workers were supervised by me”). The active voice highlights 
action. Note that writers often omit the I at the start of sentences: “Pre- 
pared bids,” rather than “I prepared bids.” Whichever style you use, be 
consistent. Figure 15.3 lists some strong verbs to use in describing your 
experience. 
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administered 

advised 

analyzed 

assembled 

built 

collected 

completed 

conducted 

constructed 


coordinated 

corresponded 

created 

delivered 

developed 

devised 

directed 

discovered 

edited 


evaluated 

examined 

expanded 

hired 

identified 

implemented 

improved 

increased 

instituted 


maintained 

managed 

monitored 

obtained 

operated 

organized 

performed 

prepared 

produced 


provided 

purchased 

recorded 

reported 

researched 

solved 

supervised 

trained 

wrote 


FIGURE 1 5.3 Strong Action Verbs Used in Resumes 

Here is a sample listing of employment history: 

June-September 2014: Student Dietitian 

Millersville General Hospital, Millersville.TX 

Gathered dietary histories and assisted in preparing menus for a 300-bed hospital. 

Received "excellent" on all seven items in evaluation by head dietitian. 

In just a few lines, you can show that you sought and accepted responsibility 
and that you acted professionally. Do not write, “I accepted responsibility”; 
instead, present facts that lead the reader to that conclusion. 

Naturally, not all jobs entail professional skills and responsibilities. Many 
students find summer work as laborers, sales clerks, and so forth. If you 
have not held a professional position, list the jobs you have held, even if they 
were unrelated to your career plans. If the job title is self-explanatory, such 
as restaurant server or service-station attendant, don’t elaborate. If you can 
write that you contributed to your tuition or expenses, such as by earning 50 
percent of your annual expenses through a job, employers will be impressed 
by your self-reliance. 

If you have held a number of nonprofessional as well as several profes- 
sional positions, group the nonprofessional ones: 

Other Employment: cashier (summer 2010), salesperson (part-time, 2011), clerk 

(summer 201 2) 

This strategy prevents the nonprofessional positions from drawing the 
reader’s attention away from the more important positions. 

If you have gaps in your employment history — because you were raising 
children, attending school, or recovering from an accident, or for other 
reasons — consider using a skills resume, which focuses more on your skills 
and less on your job history. You can explain the gaps in the job-application 
letter (if you write one) or in an interview. For instance, you could say, “I spent 
2010 and part of 2012 caring for my elderly parent, but during that time I was 
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able to do some substitute teaching and study at home to prepare for my A+ 
and Network-i- certification, which I earned in late 2012.” Do not lie or mislead 
about your dates of employment. 

If you have had several positions with the same employer, you can pre- 
sent one description that encompasses all the positions or present a separate 
description for each position. 

PRESENTING ONE DESCRIPTION 

Blue Cross of Iowa, Ames, Iowa (January 2006-present) 

• Internal Auditor II (2010-present) 

• Member Service Representative/Claims Examiner II (2008-20 1 0) 

• Claims Examiner II (2006-2008) 

As Claims Examiner II, processed national account inquiries and claims in accordance 

with After promotion to Member Service Representative/Claims Examiner II 

position, planned policies and procedures As Internal Auditor II, audit claims, 

enrollment, and inquiries; run dataset population and sample reports 

This format enables you to mention your promotions and to create a clear 
narrative that emphasizes your progress within the company. 

PRESENTING SEPARATE DESCRIPTIONS 

Blue Cross of Iowa, Ames, Iowa (January 2006-present) 

• Internal Auditor II (2010-present) 

Audit claims, enrollment, and inquiries . . . 

• Member Service Representative/Claims Examiner II (2008-20 1 0) 

Planned policies and procedures . . . 

• Claims Examiner II (2006-2008) 

Processed national account inquiries and claims in accordance with . . . 

This format, which enables you to create a fuller description of each position, 
is effective if you are trying to show that each position is distinct and you 
wish to describe the more-recent positions more fully. 

Interests and Activities The interests-and-activities section of the 
resume is the appropriate place for several kinds of information about you: 

• participation in community-service organizations, such as Big Brothers/Big 
Sisters or volunteer work in a hospital 

• hobbies related to your career (for example, electronics for an engineer) 

• sports, especially those that might be socially useful in your professional 
career, such as tennis, racquetball, and golf 

• university-sanctioned activities, such as membership on a team, work on 
the college newspaper, or election to a responsible position in an academic 
organization or a residence hall 



Writing Resumes 


15 


403 


Do not include activities that might create a negative impression, such 
as gambling or performing in a death-metal rock band. And always omit 
such activities as meeting people and reading. Everybody does these 
things. 


References Potential employers will want to learn more about you from 
your professors and previous employers. These people who are willing to 
speak or write on your behalf are called references. 

Some applicants list their references on their resume. The advantage of 
this strategy is that the potential employer can contact the references with- 
out having to contact the applicant. Other applicants prefer to wait until the 
potential employer has asked for the list. The advantage of this strategy is 
that the applicant can assemble a different set of references for each position 
without having to create different resumes. Although applicants in the past 
added a note stating “References available upon request” at the end of their 
resumes, many applicants today do not do so because they think the com- 
ment is unnecessary: employers assume that applicants can provide a list of 
references — and that they would love to do so. 

Regardless of whether you list your references on your resume, choose 
your references carefully. Solicit references only from those who know your 
work best and for whom you have done your best work — for instance, a 
previous employer with whom you worked closely or a professor from whom 
you received A’s. Don’t ask prominent professors who do not know your work 
well; they will be unable to write informative letters. 

Do not simply assume that someone is willing to serve as a reference 
for you. Give the potential reference writer an opportunity to decline grace- 
fully. The person might not have been as impressed with your work as you 
think. If you simply ask the person to serve as a reference, he or she might 
accept and then write a lukewarm letter. It is better to ask, “Would you be 
able to write an enthusiastic letter for me?” or “Do you feel you know me 
well enough to write a strong recommendation?” If the person shows any 
signs of hesitation or reluctance, withdraw the request. It may be a little 
embarrassing, but it is better than receiving a weak recommendation. 

In listing their references, some applicants add, for each reference, a sen- 
tence or two describing their relationship with the person, as shown in this 
sample listing for a reference. 

Dr. Dale Cletis 
Professor of English 
Boise State University 
Boise, ID 83725 
208.555.2637 
dcletis@boisestate.edu 

Dr. Cletis was my instructor in three literature courses, as well as my adviser. 
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Other Elements The sections discussed so far appear on almost every- 
one’s resume. Other sections are either optional or appropriate for only some 
job seekers. 

• Computer skills. Classify your skills in categories such as hardware, 
software, languages, and operating systems. List any professional 
certifications you have earned. 

• Military experience. If you are a veteran, describe your military service 
as if it were a job, citing dates, locations, positions, ranks, and tasks. List 
positive job-performance evaluations. 

• Language ability. A working knowledge of another language can be very 
valuable, particularly if the potential employer has international interests 
and you could be useful in translation or foreign service. List your 
proficiency, using terms such as beginner, intermediate, and advanced. Some 
applicants distinguish among reading, writing, and speaking abilities. 
Don’t overstate your abilities; you could be embarrassed — and without 

a job — when the potential employer hands you a business letter written 
in the language you say you know, or invites a native speaker of that 
language to sit in on the interview. 

• Willingness to relocate. If you are willing to relocate, say so. Many 
organizations will find this flexibility attractive. 

Among the issues that can pose challenges for applicants who are prepar- 
ing their resumes are questions of race, religion, and sexual orientation and 
questions about criminal records. 

Many applicants wonder whether to include information — about jobs, 
colleges, associations, and other topics — that a potential employer might use 
against them. For instance, if you attend Brigham Young University, most 
people will know that you are likely a member of the Church of Jesus Christ 
of Latter-day Saints. Being president of the LGBT association on campus 
probably signals something about your sexual identity. 

You are not obligated to reveal anything you do not wish to reveal 
(although you can’t hide the name of your college or university). If you want, 
you can write that you are the president of a campus student organization 
and not specify the name of that organization. If the potential employer 
wants to talk about it in more detail in an interview, you can decide how 
forthcoming you want to be. 

Many applicants don’t bother trying to conceal factors unrelated to the 
job. If a potential employer is going to discriminate based on religion, sexual 
orientation, or race, these applicants reason, there’s no sense wasting time 
trying to get that job because they wouldn’t want to work there, anyway. 

The question of a criminal record is more challenging for applicants. An 
applicant with a criminal record probably has a gap in his or her employ- 
ment record, but a skills resume can make that gap less obvious. An appli- 
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cant is under no obligation to mention a criminal record in a resume or 
letter, but if the potential employer asks in the application itself or in an 
interview, it is best to tell the truth. Lying would be cause for dismissal — 
and employers are very likely to discover a criminal record during a back- 
ground check. Some applicants with criminal records try to delay divulging 
that information until the interview, at which point they can explain the 
circumstances directly: they made a mistake, paid the penalty, and now are 
working hard to contribute positively. Some applicants even figure out ways 
to discuss skills they acquired — or lessons they learned — that have made 
them better employees. 

ELEMENTS OF THE SKILLS RESUME 

A skills resume differs from a chronological resume in that it includes a 
separate section, usually called “Skills” or “Skills and Abilities,” that empha- 
sizes job skills and knowledge. In a skills resume, the employment section 
becomes a brief list of information about your employment history: com- 
panies, dates of employment, and positions. Here is an example of a skills 
section. 

Skills and Abilities 

Management 

Served as weekend manager of six employees in a retail clothing business. Also 

trained three summer interns at a health-maintenance organization. 

Writing and Editing 

Wrote status reports, edited performance appraisals, participated in assembling and 

producing an environmental impact statement using desktop publishing. 

Teaching and Tutoring 

Tutored in the university writing center. Taught a two-week course in electronics for 

teenagers. Coach youth basketball. 

In a skills section, you choose the headings, the arrangement, and the 
level of detail. Your goal, of course, is to highlight the skills an employer is 
seeking. 

PREPARING A PLAIN TEXT RESUME 

Most companies use computerized applicant-tracking systems, such as RESU- 
Mate, Bullhorn, or HRsmart, to evaluate the dozens, hundreds, or even thou- 
sands of job applications they receive every day. The information from these 
applications is stored in databases, which can be searched electronically 
for keywords to generate a pool of applicants for specific positions. Once a 
pool of candidates has been generated, someone at the company reads their 
resumes. Prepare a plain-text resume so that you can survive this two-stage 
process. 
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Many of the job boards listed on 
p. 393 include samples of resumes. 


A plain-text resume, also called a text resume, ASCII resume, or electronic 
resume, is a resume that uses a very limited character set and has little for- 
matting so that it can be stored in any database and read by any software. It 
will not be as attractive as a fully formatted document created with a word 
processor, but if you prepare it carefully it will say what you want it to say 
and be easy to read. 


4 \ 


GUIDELINES 


Formatting a Plain-Text Resume 


Start with the resume that you prepared in Word or with some other word- 
processing software. Save it as "Plain text"and then paste it into Notepad or another 
text editor. Revise the Notepad version so that it has these five characteristics: 


► It has no special characters. It uses only the letters, numbers, and basic punc- 
tuation marks visible on your keyboard. That is, it does not use boldface, italics, 
bullets, or tabs. 

► It has a line length of 65 or fewer characters. Use the space bar to break longer 
lines or, in Notepad, set the left and right margins (in File/Page Setup) to 1 .5 inches. 

► It uses a non-proportional typeface such as Courier. (A non-proportional type- 
face is one in which each letter takes up the same amount of space on the line; 
narrow letters are surrounded by a lot of space, whereas wider letters are sur- 
rounded by a smaller space.) Using a non-proportional typeface makes it easier 
to keep the line length to 65 characters. 

► Most of the information is left justified. If you want, you can use the space bar 
(not the Tab key) to move text to the right. For instance, you might want to center 
the main headings. 

► It uses ALL UPPERCASE or repeated characters for emphasis. For example, a 
series of equal signs or hyphens might signal a new heading. 


You might want to create two versions of your plain-text resume: a 
version using Word Wrap (in Notepad’s Format tab) to be attached to an 
email, and a version not using Word Wrap to be pasted into the body of an 
email. 

Check each new version to be sure the information has converted prop- 
erly. Copy and paste the version not using Word Wrap into an email and send 
it to yourself, and then review it. Attach the new file using Word Wrap to an 
email, open it in your text editor, and review it. 

Figures 15.4 and 15.5 show a plain-text chronological resume and a plain- 
text skills resume. 
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CARL OPPENHEIMER 
3109 Vista Street 
Philadelphia, PA 19136 
(215) 555-3880 
coppen@dragon . du . edu 

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 

SUMMARY 

Recent BSEE graduate with experience as an electrical 
engineer intern for RCA Advanced Technology Laboratory. 
Analytical, technical, and communication skills for labo- 
ratory and customer-facing applications. Strong under- 
standing of large-scale integrated systems and CMOS appli- 
cations . 

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 

EDUCATION 

BS in Electrical Engineering 6/2015 
Drexel University, Philadelphia, PA 
Grade-Point Average: 3.67 (on a scale of 4.0) 

Senior Design Project: "Enhanced Path-Planning Software 
for Robotics" 

+++Advanced Engineering Courses 
Digital Signal Processing 
Computer Hardware 

Introduction to Operating Systems I, II 

Systems Design 

Digital Filters 

Computer Logic Circuits I, II 

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 

EMPLOYMENT 

6/2012-1/2013 Electrical Engineering Intern II 
RCA Advanced Technology Laboratory, Moorestown, NJ 
Designed ultra-large-scale integrated circuits using 
VERILOG and VHDL hardware description languages. Assisted 
senior engineer in CMOS IC layout, modeling, parasitic 
capacitance extraction, and PSPICE simulation operations. 
+++6/2011-1/2012 Electrical Engineering Intern I 
RCA Advanced Technology Laboratory, Moorestown, NJ 
Verified and documented several integrated circuit 
designs. Used CAD software and hardware to simulate, 
check, and evaluate these designs. Gained experience with 
Mathcad . 

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
HONORS AND ORGANIZATIONS 

Eta Kappa Nu (Electrical Engineering Honor Society) 

Tau Beta Pi (General Engineering Honor Society) 

IEEE 


The writer provides his contact 
information, including his email 
address. 


This plain-text resume uses only 
plus signs to signal new headings. 
Notice that all information is left- 
justified. 

The writer presents a summary 
statement. Some applicants find 
it awkward to praise themselves, 
describing their skills, but it is 
important to have keywords such 
as"analytical skills" in the resume, 
particularly if the job ad mentioned 
them. 


The writer chooses to emphasize his 
advanced engineering courses. For 
another job, he might emphasize 
other courses. 


The writer wisely creates a category 
that calls attention to his academic 
awards and his membership in his 
field's major professional organiza- 
tion. 

The writer does not include his 
references or write "References 
available upon request." If the 
reader invites him to proceed to the 
next step in the process, Carl will 
send a list of references, with their 
contact information. 


FIGURE 1 5.4 Chronological Resume of a Traditional Student 
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In a skills resume, you present the 
skills section at the start. This orga- 
nization lets you emphasize your 
professional attributes. Notice that 
the writer uses specific details — 
names of software, number of 
credits, types of documents, kinds 
of activities — to make her case. 


The employment section contains a 
list of positions rather than descrip- 
tions of what the writer did in each 
position. 

The volunteer position says some- 
thing about the writer's character. 


The writer believes that the skills 
required in raising children are 
relevant in the workplace. Other 
applicants might think that because 
a resume describes job credentials, 
this information should be omitted. 


Alice P. Linder 
1781 Weber Road 
Rawlings, MT 59211 
(406) 555-3999 
linderap423@gmail . com 

SUMMARY 

Biotechnology major with broad laboratory experience at Glaxo- 
SmithKline, analyzing molecular data and writing C# programs. 
Working toward Certification in laboratory specialty through 
ASCP . Strong written and oral communication skills. Extensive 
volunteer experience in physical therapy for children. Experi- 
ence managing business office. 


SKILLS AND ABILITIES 
Laboratory Skills 

-Analyzed molecular data on E&S PS300, Macintosh, and IBM PCs. 
Wrote programs in C# . 

-Have taken 12 credits in biology and chemistry labs. 
Communication Skills 

-Wrote a user's guide for an instructional computing package. 
-Trained and consulted with scientists and delivered in-house 
briefings . 

Management Skills 

-Managed 12-person office in $1.2 million company. 


EDUCATION 

Central Montana State University, Rawlings, MT 

BS in Bioscience and Biotechnology 

Expected Graduation Date: 6/2015 

Related Course Work 

General Chemistry I, II, III 

Biology I, II, III 

Organic Chemistry I, II 

Calculus I, II 

Statistical Methods for Research 
Physics I, II 
Technical Communication 


EMPLOYMENT EXPERIENCE 

6/2012 -present (20 hours per week) : Laboratory Assistant Grade 3 
GlaxoSmithKline, Rawlings, MT 

8/2009-present: Volunteer, Physical Therapy Unit 
Rawlings Regional Medical Center, Rawlings, MT 
6/2001-1/2004: Office Manager 
Anchor Products, Inc., Rawlings, MT 


HONORS 


Awarded three $5,000 tuition scholarships 
Gould Foundation. 

ADDITIONAL INFORMATION 

Member, CMSU Biology Club, Yearbook Staff 
Raising three school-age children 
Tuition 100% self-financed 


(2011-2013) 


from the 


FIGURE 15.5 Skills Resume of a Nontraditional Student 
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Although fewer and fewer employers request a formatted resume, some 
still do. Some applicants send formatted resumes in addition to their plain- 
text resumes. Figure 15.6 shows a formatted version of the resume presented 
in Figure 15.5. 


Alice P. Linder 

1 781 Weber Road (406) 555-3999 

Rawlings, MT 5921 1 Iinderap423@gmail.com 

Summary 

Biotechnology major with broad laboratory experience 
at GlaxoSmithKline, analyzing molecular data and 
writing C# programs. Working toward Certification in 
laboratory specialty through ASCP. Strong written and 
oral communication skills. Extensive volunteer experience 
in physical therapy for children. Experience managing 
business office. 

Skills and Abilities 

Laboratory Skills 

• Analyzed molecular data on E&S PS300, Macintosh, and 
IBM PCs. Wrote programs in C#. 

• Have taken 1 2 credits in biology and chemistry labs. 
Communication Skills 

• Wrote a user's guide for an instructional computing 
package. 

• Trained and consulted with scientists and delivered in- 
house briefings. 

Management Skills 

• Managed 12-person office in a $1.2 million company. 

Education 

Central Montana State University, Rawlings, MT 
BS in Bioscience and Biotechnology 
Expected Graduation Date: June 201 5 
Related Course Work 

General Chemistry 1, II, III Biology 1, II, III 
Organic Chemistry 1, II Statistical Methods for Research 

Physics 1, II Technical Communication 

Calculus 1, II 

Employment 

6/2012-present (20 hours/week) 

Experience 

GlaxoSmithKline, Rawlings, MT 
Laboratory Assistant Grade 3 
8/2009-present 

Rawlings Regional Medical Center, Rawlings, MT 
Volunteer, Physical Therapy Unit 
6/2001-1/2004 

Anchor Products, Inc., Rawlings, MT 
Office Manager 

Honors 

Awarded three $5,000 tuition scholarships (201 1 -201 3) 
from the Gould Foundation. 

Additional 

Member, CMSU Biology Club, Yearbook Staff 

Information 

Raising three school-age children 
Tuition 100 percent self-financed 


FIGURE 15.6 

Formatted Version 
of a Skills Resume 


You have many more formatting 
options when you present your 
resume on paper. 

This writer has used a two-column 
table to organize the information. 
The left column presents the head- 
ings; the right column presents the 
data. The advantage of using a table 
rather than moving text using tabs 
is that you can use different text 
attributes (for instance, the head- 
ings can be boldfaced, set in a dif- 
ferent typeface, or set in a different 
size) without having to worry about 
whether the different attributes will 
alter the line spacing. In addition, if 
you use a table, you can easily revise 
and edit; with tabs, your editing 
will create awkward line breaks and 
alignment. 
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DOCUMENT ANALYSIS ACTIVITY 


Preparing a Resume 


This resume was written by a 
graduating college senior who 
wanted to work for a wildland 
firefighting agency such as the 
U.S. Bureau of Land Manage- 
ment or U.S. Forest Service. The 
writer plans to save the resume 
as a .txt file and enter it directly 
into these agencies' employ- 
ment databases. The ques- 
tions below ask you to think 
about electronic resumes (as 
discussed on pp. 405-06). 

1 . Flow effectively has the 
writer formatted this 
resume? 

2 . What elements are likely to 
be problematic when the 
writer saves this resume as a 
.txt file? 

3 . What is the function of the 
industry-specific jargon in 
this resume? 

4 . Why does the writer place 
the education section below 
the sections on career 
history and fire and aviation 
qualifications? 


BURTON L. KREBS 

34456 West Jewell St. 208-555-9627 

Boise, ID 83704 burtonkrebs@mail.com 

Objective 

Lead crew position on rappel crew. 

Career History 

• Senior Firefighter, Moyer Rappel Crew, 05/14-present 

• Senior Firefighter, Boise Helitack, 05/1 3-1 0/1 3 

• Hotshot Crew Member, Boise Interagency Hotshot Crew, 07/1 2- 
09/12 

• Helirappel Crew Member, Moyer Rappel Crew, 06/08-09/1 1 
Fire and Aviation Qualifications 

Crew Boss (T) 

Helicopter Manager 
Helicopter Rappeller 
Helirappel Spotter 
Helispot Manager 
Type 2 Helibase Manager (T) 

Incident CommanderType 4 (T) 

Education 

Bachelor of Arts in Communication Training and Development, Boise State 
University, Boise, Idaho, GPA 3.57, May 201 5 

Skills 

• Excellent oral and written communication skills 

• Proficient in Word, Excel, and PowerPoint 

• Knowledgeable of helicopter contract administration 

• Perform daily and cumulative flight invoice cost summaries 

Awards 

"Outstanding Performance" Recognition, U.S. Bureau of Land 
Management, 2013 

"Outstanding Performance" Recognition, U.S. Forest Service, 2010, 201 1, 
2012 
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DOCUMENT ANALYSIS ACTIVITY 


To analyze an online professional portfolio, go to 
"Document Analysis Activities" under "Additional 
Resources" in Ch. 15: macmillanhighered.com 
/launchpad/techcomml 1 e. 


Blane C. Holden's Online Portfolio 

Used by permission of Blane Holden. 


Writing Job-Application Letters 

Is the job-application letter (sometimes called a couer letter) obsolete? Resume 
expert Tony Beshara surveyed over 3,000 hiring officers for their opinions. 
Some 86 percent said the letter is “not very important” (Hering, 2011). But 
many experts argue that a cover letter is still important. Applicants can 
explain more clearly in a letter than in a resume how their qualifications 
match the employer’s requirements. They can explain their professional 
relationship with someone in the employer’s organization or gaps in their 
employment history. Perhaps most important, applicants can show that they 
can write well. In a survey by the professional staffing company Robert Half 
International, 91 percent of senior managers said that a letter is valuable, and 
79 percent reported that they often receive cover letters from applicants even 
when they do not request them (OfficeTeam, 2011). 

Figure 15.7 shows a job-application letter. 


Many of the job boards listed on 
p. 393 include samples of job- 
application letters. 


Preparing for a Job Interview 

If your resume is successful, you will be invited to a job interview, where 
both you and the organization can start to see whether you would be a good 
fit there. Job boards on the Internet can help you prepare for a job interview. 
They discuss questions such as the following: 

• When should you arrive for the interview? 

• What should you wear? 
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For information about letter format- 
ting, seeCh. 14, p.363. 

Notice that the writer's own name 
does not appear at the top of his 
letter. 

In the inside address, he uses the 
reader's courtesy title, "Mr." 

The introductory paragraph identi- 
fies the writer's source of informa- 
tion about the job, identifies the 
position he is applying for, states 
that he wishes to be considered, 
and forecasts the rest of the letter. 

In a letter, you can't discuss every- 
thing in the resume. Rather, you 
select a few key points from the 
resume to emphasize. 

Note that both the education 
paragraph and the employment 
paragraph begin with a clear topic 
sentence. 

The writer points out that he has 
taken two graduate courses, and he 
discusses his senior design project, 
which makes him look more like an 
engineer solving a problem than a 
recent graduate. 

Notice how the writer makes a 
smooth transition from the discus- 
sion of his college education to 
the discussion of his internship 
experience. 

A concluding paragraph usually 
includes a reference to the resume, 
a polite but confident request for an 
interview, and the writer's contact 
information. 

The enclosure notation refers to 
the writer's resume. Do not use an 
enclosure notation unless you are 
literally enclosing something along 
with the letter in the envelope. 


3 109 Vista Street 
Philadelphia, PA 19136 

January 20, 201 5 

Mr. Stephen Spencer, Director of Personnel 

Department 41 1 

Boeing Naval Systems 

103 Industrial Drive 

Wilmington, DE 20093 

Dear Mr. Spencer: 

I am writing in response to your advertisement in the January 1 6 
Philadelphia Inquirer. Would you please consider me for the position 
in Signal Processing? I believe that my academic training in electrical 
engineering at Drexel University, along with my experience with the RCA 
Advanced Technology Laboratory, qualifies me for the position. 

My education at Drexel has given me a strong background in computer 
hardware and system design. I have concentrated on digital and 
computer applications, developing and designing computer and signal- 
processing hardware in two graduate-level engineering courses. For 
my senior design project, I am working with four other undergraduates 
in using OO programming techniques to enhance the path-planning 
software for an infrared night-vision robotics application. 

While working at the RCA Advanced Technology Laboratory, I was able to 
apply my computer experience to the field of DSP. I designed ultra-large- 
scale integrated circuits using VERILOG and VHDL hardware description 
languages. In addition, I assisted a senior engineer in CMOS 1C layout, 
modeling, parasitic capacitance extraction, and PSPICE simulation 
operations. 

The enclosed resume provides an overview of my education and 
experience. Could I meet with you at your convenience to discuss my 
qualifications for this position? Please leave a message any time at (215) 
555-3880 or email me at coppen@dragon.du.edu. 

Yours truly, 

OJt — 

Carl Oppenheimer 

Enclosure (1) 


FIGURE 15.7 Job-Application Letter 
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• How might interviewers interpret your body language? 

• What questions are you likely to be asked? 

• How long should your answers be? 

• How do you know when the interviewer wishes to end the interview? 

• How can you get the interviewer’s contact information so you can write a 
follow-up letter? 


4\ 


GUIDELINES 


Preparing for a Job Interview 


For every hour you spend in a job interview, you need to spend many hours in 
preparation. 


► Study job interviews. The hundreds of books and websites devoted to job 
interviews cover everything from how to do your initial research to common 
interview questions to how to dress. Although you can't prepare for everything 
that will happen, you can prepare for a lot of things. 

► Study the organization to which you applied. If you show that you haven't done 
your homework, the interviewer might conclude that you're always unprepared. 
Learn what products or services the organization provides, how well it has done 
in recent years, what its plans are, and so forth. Start with the organization's own 
website, especially corporate blogs, and then proceed to other online and print 
resources. Search for the organization's name on the Internet. 

► Think about what you can offer the organization. Your goal during the interview 
is to show how you can help the organization accomplish its goals. Think about 
how your academic career, your work experience, and your personal characteris- 
tics and experiences have prepared you to solve problems and carry out projects 
to help the organization succeed. Make notes about projects you carried out in 
courses, experiences on the job, and experiences in your personal life that can 
serve as persuasive evidence to support claims about your qualifications. 

► Study lists of common interview questions. Interviewers study these lists; you 
should, too. You're probably familiar with some of the favorites: 

— Can you tell me about yourself? 

— Where do you see yourself in five years? 

— Why did you apply to our company? 

— What do you see as your greatest strengths and weaknesses? 

— Tell me about an incident that taught you something important about 
yourself. 

— What was your best course in college? Why? 

► Compile a list of questions you wish to ask. Near the end of the interview, the 
interviewer will probably ask if you have any questions. The interviewer expects 
you to have compiled a brief list of questions about working for the organization. 


For more about research techniques, 
see Ch. 6. 


For more about communicating 
persuasively, see Ch. 8. 


( continued ) 
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Do not focus on salary, vacation days, or sick leave. Instead, ask about ways you 
can continue to develop as a professional, improving your ability to contribute to 
the organization. 

► Rehearse the interview, it's one thing to think about how you might answer an 
interview question. It's another to have to answer it. Rehearse for the interview by 
asking friends or colleagues to play the role of the interviewer, making up ques- 
tions that you haven't thought about. Then ask these people for constructive 
criticism. 


• Letter of appreciation after an interview. Thank the organization’s 

representative for taking the time to see you, and emphasize your particular 
qualifications. You can also restate your interest in the position and 
mention a specific topic of conversation you found particularly interesting 
or a fact about the position you found exciting. A follow-up letter can 
do more good with less effort than any other step in the job-application 
procedure because so few candidates take the time to write one. 

Dear Mr. Weaver: 

Thank you for taking the time yesterday to show me your facilities and to introduce 
me to your colleagues. 

Your company's advances in piping design were particularly impressive. As a person 
with hands-on experience in piping design, I can appreciate the advantages your 
design will have. 

The vitality of your projects and the good fellowship among your employees further 
confirm my initial belief that Cynergo would be a fine place to work. I would look 
forward to joining your staff. 

Sincerely yours. 


Harriet Bommarito 

• Letter accepting a job offer. This one is easy: express appreciation, show 
enthusiasm, and repeat the major terms of your employment. 

Dear Mr. Weaver: 

Thank you very much for the offer to join your staff. I accept. 


Writing Follow-up Letters or 
Emails After an Interview 


Many of the job boards listed on 
p. 393 include samples of follow-up 
letters for different situations that 
occur during a job search. 


After an interview, you should write a letter or email of appreciation. If you 
are offered the job, you also may have to write a letter accepting or rejecting 
the position. 




Writing Follow-up Letters or Emails After an Interview 
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I look forward to joining your design team on Monday, July 19. The salary, as you 
indicate in your letter, is $48,250. 

As you have recommended, I will get in touch with Mr. Matthews in Personnel to get a 
start on the paperwork. 

I appreciate the trust you have placed in me, and I assure you that I will do what I can 
to be a productive team member at Cynergo. 

Sincerely yours, 


Mark Greenberg 

• Letter rejecting a job offer. If you decide not to accept a job offer, express 
your appreciation for the offer and, if appropriate, explain why you are 
declining it. Remember, you might want to work for this company at some 
time in the future. 

Dear Mr. Weaver: 

I appreciate very much the offer to join your staff. 

Although I am certain that I would benefit greatly from working at Cynergo, I have 
decided to take a job with a firm in Baltimore, where I have been accepted at Johns 
Hopkins to pursue my Master's degree at night. 

Again, thank you for your generous offer. 

Sincerely yours, 


Cynthia O'Malley 

• Letter acknowledging a rejection. Why write back after you have been 
rejected for a job? To maintain good relations. You might get a phone call 
the next week explaining that the person who accepted the job has had a 
change of plans and offering you the position. 

Dear Mr. Weaver: 

I was disappointed to learn that I will not have a chance to join your staff, because I 
feel that I could make a substantial contribution. However, I realize that job decisions 
are complex, involving many candidates and many factors. 

Thank you very much for the courtesy you have shown me. 

Sincerely yours, 





Paul Goicochea 
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WRITER'S CHECKLIST 


Resume 

EJ Does the resume include appropriate keywords? (p. 397) 
Does the identifying information contain your name, 
address(es), phone number(s), and email address(es)? 

(p. 398) 

Does the resume include a clear summary of your 
qualifications? (p. 398) 

EE Does the education section include your degree, your 
institution and its location, and your (anticipated) date 
of graduation, as well as any other information that will 
help a reader appreciate your qualifications? (p. 399) 
Does the employment section include, for each job, 
the dates of employment, the organization's name and 
location, and (if you are writing a chronological resume) 
your position or title, as well as a description of your 
duties and accomplishments? (p. 400) 

EJ Does the interests-and-activities section include relevant 
hobbies or activities, including extracurricular interests? 
(p. 402) 

I Have you omitted any personal information that might 
reflect poorly on you? (p. 403) 

Q Does the resume include any other appropriate sections, 
such as skills and abilities, military service, language 
abilities, or willingness to relocate? (p. 404) 

Job-Application Letter 

EJ Does the letter look professional? (p.411) 

EJ Does the introductory paragraph identify your source of 
information and the position you are applying for, state 
that you wish to be considered, and forecast the rest of 
the letter? (p.412) 

EJ Does the education paragraph respond to your 

reader's needs with a unified idea introduced by a topic 
sentence? (p.412) 


JJ Does the employment paragraph respond to your 

reader's needs with a unified idea introduced by a topic 
sentence? (p.412) 

JJ Does the concluding paragraph include a reference to 
your resume, a request for an interview, your phone 
number, and your email address? (p.412) 

JJ Does the letter include an enclosure notation? (p. 4 12) 

Preparing for a Job Interview 

Did you 

EJ study job interviews? (p. 413) 

EJ study the organization to which you applied? (p.413) 

EJ think about what you can offer the organization? (p.413) 

EJ study lists of common interview questions? (p.413) 

□ compile a list of questions you wish to ask? (p.413) 

EJ rehearse for the interview? (p.414) 

Follow-up Letters 

EJ Does your letter of appreciation for a job interview thank 
the interviewer and briefly restate your qualifications? 
(p.414) 

EJ Does your letter accepting a job offer show enthusiasm 
and repeat the major terms of your employment? 

(p.414) 

EH Does your letter rejecting a job offer express your 
appreciation for the offer and, if appropriate, explain 
why you are declining it? (p.415) 

3 Does your letter acknowledging a rejection have a 

positive tone that will help you maintain good relations? 
(p. 41 5) 


EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1. Browse a job-search website such as lndeed.com. Then, 
list and briefly describe five positions being offered in 
a field that interests you. What skills, experience, and 
background does each position require? What is the 
salary range for each position? 


2. Locate three job websites that provide interactive forms 
for creating a resume automatically. In a brief memo to 
your instructor, note the three URLs and describe the 
strengths and weaknesses of each site. Which job board 
appears to be the easiest to use? Why? 
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3 . The following resume was submitted in response to this 
ad: "CAM Technician to work with other technicians and 
manage some GIS and mapping projects. Also perform 
updating of the GIS database. Experience required." In a 
brief memo to your instructor, analyze the effectiveness 
of the resume. What are some of its problems? 


Kenneth Bradley 

530 Maplegrove Bozeman, Mont. 59715 (406)-484-2916 


Objective 


Education 

Employment 


References 


Entry level position as a CAM Technician. 
I am also interested in staying with 
the company until after graduation, 
possibly moving into a position as a 
Mechanical Engineer. 

Enrolled at Montana State University 

August 201 3- Present 

Fred Meyer 

65520 Chinden 

Garden City, MT 

(208)-323-7030 

Janitor- 7/12-6/13 

Responsible for cleaning entire store, 

as well as equipment maintenance and 

floor maintenance and repair. 

Assistant Janitorial Manager- 6/1 3-9/1 3 
Responsible for cleaning entire 
store, equipment maintenance, floor 
maintenance and repair, scheduling, 
and managing personnel 
Head of Freight- 9/13-Present 
In charge of braking down all new 
freight, stocking shelves, cleaning the 
stock room, and managing personnel 
Montana State University 
Bozeman, MT 

Teachers Aide ME 120- 1/12-5/12 
Teachers Aide ME 120 

In charge of keeping students in line 
and answering any questions related to 
drafting. 

Timothy Rayburn 
Janitorial Manager 
(406)-555-8571 
Eduardo Perez 
Coworker 
(406)-555-2032 


4 . The following job-application letter responds to this ad: 
"CAM Technician to work with other technicians and 


manage some GIS and mapping projects. Also perform 
updating of the GIS database. Experience required." In a 
brief memo to your instructor, analyze the effectiveness 
of the letter and suggest how it could be improved. 

530 Maplegrove 
Bozeman, Mont. 59715 
November 1 1, 2015 

Mr. Bruce Hedley 
Adecco Technical 
Bozeman, Mont. 59715 

Dear Mr. Hedley, 

I am writing you in response to your ad on Monsterjobs. 
com. Would you please consider me for the position of 
CAM technician? I believe that my academic schooling 
at Montana State University, along with my work 
experience would make me an excellent candidate for 
the position. 

While at Montana State University, I took one class in 
particular that applies well to this job. It was a CAD 
drafting class, which I received a 97% in. The next 
semester I was a Teachers Aid for that same class, where 
I was responsible for answering questions about drafting 
from my peers. This gave me a much stronger grasp on all 
aspects of CAD work than I could have ever gotten from 
simply taking the class. 

My employment at Fred Meyer is also a notable 
experience. While there is no technical aspects of either 
positions I have held, I believe that my experience there 
will shed light on my work ethic and interpersonal skills. 

I started out as a graveyard shift janitor, with no previous 
experience. All of my coworkers were at least thirty 
years older than me, and had a minimum of five years of 
janitorial experience. However after working there for 
only one year I was promoted to assistant manager. Three 
months after I received this position, I was informed that 
Fred Meyer was going to contract out the janitorial work 
and that all of us would be losing our jobs. I decided that 
I wanted to stay within the company, and I was able to 
receive a position as head of freight. 

The enclosed resume provides an overview of my 
education and work experience. I would appreciate 
an opportunity to meet with you at your convience to 
disscuss my qualifications for this position. Please write 
me at the above address or leave a message any time. If 
you would like to contact me by email, my email address is 
kbradley@montanastate.edu. 

Yours truly, 

Ken Bradley 
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5. How effective is the following letter of appreciation? 
How could it be improved? Present your findings in a 
brief memo to your instructor. 

914 Imperial Boulevard 
Durham, NC 27708 

November 13, 2015 
Mr. Ronald O'Shea 
Division Engineering 
Safeway Electronics, Inc. 

Holland, Ml 49423 

Dear Mr. O'Shea: 

Thanks very much for showing me around your plant. I 
hope I was able to convince you that I'm the best person 
for the job. 

Sincerely yours, 

Robert Harad 


6. In a newspaper or journal or on the Internet, find an 
ad for a position in your field for which you might be 
qualified. Write a resume and a job-application letter in 
response to the ad; include the job ad or a photocopy. 
You will be evaluated not only on the content and 
appearance of the materials, but also on how well you 
have targeted them to the job ad. 


CASE 15: Identifying the Best-of-the-Best Job-Search Sites 


After the director of the Career Center at your school visits one of your classes, you decide 
to visit the Career Center's website. You study the available resources, but you find that 
they don't offer as much support as you and your fellow classmates need navigating the 
online job-search environment for the first time. You decide to write the director with your 
concerns. She agrees with your critique and asks you to research online information about 
job searching and begin putting together a new job-search resource for seniors at your 
college. To get started with your project, go to "Cases" under "Additional Resources" in 
Ch. 15: macmillanhighered.com/launchpad/techcomm11e. 
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A PROPOSAL IS an offer to carry out research or to provide a product or service. 
For instance, a physical therapist might write a proposal to her supervisor for 
funding to attend a convention to learn about current rehabilitation practices. A 
defense contractor might submit a proposal to design and build a fleet of drones 
for the Air Force. A homeless shelter might submit a proposal to a philanthropic 
organization for funding to provide more services to the homeless community. 
Whether a project is small or big, within your own company or outside it, it is 
likely to call for a proposal. 


Understanding the Process of Writing Proposals 

Writing a proposal calls for the same process of planning, drafting, revising, 
editing, and proofreading that you use for other kinds of documents. The 
Focus on Process box on the next page presents an overview of this process. 


The Logistics of Proposals 

Proposals can be classified as either internal or external; external proposals 
are either solicited or unsolicited. Figure 16.1 shows the relationships among 
these four terms. 

INTERNAL AND EXTERNAL PROPOSALS 

Internal proposals are submitted to the writer’s own organization; external 
proposals are submitted to another organization. 


Proposals 


Solicited 


External 


Internal 


Unsolicited 


FIGURE 16.1 The Logistics of Proposals 
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FOCUS ON PROCESS 


When writing a proposal, pay special attention to these steps in the writing process. 


PLANNING 


Consider your readers' knowledge about and attitudes toward 
what you are proposing. Use the techniques discussed in 
Chapters 5 and 6 to learn as much as you can about your readers' 
needs and about the subject. Also consider whether you have 
the personnel, facilities, and equipment to do what you propose 
to do. 


DRAFTING 


Collaboration is critical in large proposals because no one 
person has the time and expertise to do all the work. See 
Chapter 4 for more about collaboration. In writing the proposal, 
follow the instructions in any request for proposal (RFP) or 
information for bid (IFB) from the prospective customer. If there 
are no instructions, follow the structure for proposals outlined in 
this chapter. 



External proposals usually have a firm deadline. Build in time 
to revise, edit, and proofread the proposal thoroughly and 
still get it to readers on time. See the Writer's Checklist on 
page 443. 


Internal Proposals An internal proposal is an argument, submitted 
within an organization, for carrying out an activity that will benefit the 
organization. An internal proposal might recommend that the organization 
conduct research, purchase a product, or change some aspect of its policies 
or procedures. 

For example, while working on a project in the laboratory, you realize that 
if you had a fiber-curl measurement system, you could do your job better and 
faster. The increased productivity would save your company the cost of the 
system in a few months. Your supervisor asks you to write a memo describ- 
ing what you want, why you want it, what you’re going to do with it, and 
what it costs; if your request seems reasonable and the money is available, 
you’ll likely get the new system. 

Often, the scope of a proposal determines its format. A request for a small 
amount of money might be conveyed orally or by email or a brief memo. A 
request for a large amount, however, is likely to be presented in a formal 
report. 

External Proposals No organization produces all the products or pro- 
vides all the services it needs. Websites need to be designed, written, and 
maintained; inventory databases need to be created; facilities need to be 
constructed. Sometimes projects require unusual expertise, such as sophisti- 
cated market analyses. Because many companies supply these products and 
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services, most organizations require that a prospective supplier compete for 
the business by submitting a proposal, a document arguing that it deserves 
the business. 

SOLICITED AND UNSOLICITED PROPOSALS 

External proposals are either solicited or unsolicited. A solicited proposal is 
submitted in response to a request from the prospective customer. An unso- 
licited proposal is submitted by a supplier who believes that the prospective 
customer has a need for goods or services. 

Solicited Proposals When an organization wants to purchase a product 
or service, it publishes one of two basic kinds of statements: 

• An information for bid (IFB) is used for standard products. When a state 
agency needs desktop computers, for instance, it informs computer 
manufacturers of the configuration it needs. All other things being equal, 
the supplier that offers the lowest bid for a product with that configuration 
wins the contract. When an agency solicits bids for a specific brand and 
model, the solicitation is sometimes called a request for quotation (RFQ). 

• A request for proposal (RFP) is used for more-customized products or 
services. For example, if the Air Force needs an “identification, friend 
or foe” system, the RFP it publishes might be a long and detailed set of 
technical specifications. The supplier that can design, produce, and deliver 
the device most closely resembling the specifications — at a reasonable 
price — will probably win the contract. 

Most organizations issue IFBs and RFPs in print and online. Government 
solicitations are published on the FedBizOpps website. Figure 16.2 shows a 
portion of an RFQ. 

Unsolicited Proposals An unsolicited proposal is like a solicited proposal 
except that it does not refer to an RFP. In most cases, even though the poten- 
tial customer did not formally request the proposal, the supplier was invited 
to submit the proposal after people from the two organizations met and 
discussed the project. Because proposals are expensive to write, suppliers are 
reluctant to submit them without assurances that they will be considered 
carefully. Thus, the word unsolicited is only partially accurate. 


The "Deliverables" of Proposals 

A deliverable is what a supplier will deliver at the end of a project. Deliverables 
can be classified into two major categories: research or goods and services. 

RESEARCH PROPOSALS 

In a research proposal, you are promising to perform research and then 
provide a report about it. For example, a biologist for a state bureau of land 
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Solicitation Number: NIHCCOPC1 301 4476 

The Clinical Center at the National Institutes of Health (NIH) in Bethesda, 
Maryland, is one of the 27 institutes and centers that comprise NIH. The NIH 
Clinical Center is the nation's largest hospital devoted entirely to clinical 
research. With patients from all over the United States and some from abroad, 
the Clinical Center provides medical care and research services to support 
patients participating in over 1500 active protocol sponsored by the NIH 
Institutes. The Office of Patient Recruitment (OPR) reports to the Clinical 
Center Office of the Director. OPR is responsible for supporting the NIH 
intramural program by providing patient recruitment services for Institutes, 
staffing a call center to receive public inquiries, providing services to support 
the clinical research volunteer program, and serving as the NIH Intramural 
Liaison for Research Match (RM), an on-line recruitment tool. 

The NIH has a requirement for call center services. Please see the attached 
Statement of Work. This is anticipated for up to four (4) full time positions 
onsite at the NIH Clinical Center. Offerors are to submit resumes with 
documentation for medical terminology training. Offerors may submit 
multiple resumes for positions. 

Evaluation Criteria 

Approach 30%: Proposal meets requirements and indicates an exceptional 
approach and understanding of the requirements. Risk of unsuccessful 
performance is very low. Adequacy of ability to meet the volume of contacts. 
Ability to provide consistent staffing and standards of staff performance. 

Staffing 30%: Evidence of a broad pool of applicants that have been placed 
in the metropolitan DC area with the skill set desired within the last 2 years. 
Proposed staff meets the requirements (experience and credentialing) as 
stated in the Statement of Work. Staff has relevant experience with volume 
of contacts. Staff are recruited and retained. Ability to meet the 48 hours 
replacement time. 

Corporate Experience 25%: Adequacy of the contractor's prior experience 
in providing support. The information shall include sufficient information to 
demonstrate previous effectiveness of staffing and oversight on performance. 

Past Performance 15%: The quotation will be evaluated on 3 recent 
references (within the last 5 years.) 

Price Best Value 

The government will evaluate the total price contained in the contractor's 
proposal. With the understanding and ability to project costs which are 
reasonable and indicates that the contractor understands the nature and 
extent of the work to be performed. 

Period of Performance is one year September, 2013 to September, 2014 with 
up to 4 successive options. 


FIGURE 16.2 

Excerpt from an RFQ 

Source: FedBizOpps.gov, 2013: https:// 
www.fbo.gov/index?s=opportunity& 
mode=form&id=56fb 1 ee0948a2f565f25 
29a 1 1 7e2affd&tab=core&_cview=0. 


This is an excerpt from an RFQ from 
the National Institutes of Health 
(NIH). The NIH is seeking to hire 
up to four call-center personnel. 
The specific details of the skills and 
experience required for the four 
persons are provided in a separate 
file. 

This RFQ spells out the evaluation 
criteria by which the "offerors" will 
be judged. 


The RFQ states that the solicitation 
is for "price best value." In other 
words, the contract will not neces- 
sarily be awarded to the lowest 
bidder. It will be awarded to the 
bidder that offers what the evalua- 
tors consider to be the best value, 
regardless of price. 
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For more about progress reports and 
recommendation reports, see Ch. 1 7, 
p. 451, and Ch. 18. 


management writes a proposal to the National Science Foundation request- 
ing resources to build a window-lined tunnel in the forest to study tree and 
plant roots and the growth of fungi. The biologist also wishes to investigate 
the relationship between plant growth and the activity of insects and worms. 
The deliverable will be a report submitted to the National Science Foundation 
and, perhaps, an article published in a professional journal. 

Research proposals often lead to two other applications: progress reports 
and recommendation reports. 

After a proposal has been approved and the researchers have begun 
work, they often submit one or more progress reports, which tell the sponsor 
of the project how the work is proceeding. Is it following the plan of work 
outlined in the proposal? Is it going according to schedule? Is it staying 
within budget? 

At the end of the project, researchers prepare a recommendation report, 
often called a final report, a project report, a completion report, or simply a report. 
A recommendation report tells the whole story of a research project, begin- 
ning with the problem or opportunity that motivated it and continuing with 
the methods used in carrying it out, the results, and the researchers’ conclu- 
sions and recommendations. 

People carry out research projects to satisfy their curiosity and to advance 
professionally. Organizations often require that their professional employees 
carry out research and publish in appropriate journals or books. Government 
researchers and university professors, for instance, are expected to remain 
active in their fields. Writing proposals is one way to get the resources — time 
and money for travel, equipment, and assistants — to carry out research. 

GOODS AND SERVICES PROPOSALS 

A goods and services proposal is an offer to supply a tangible product (a fleet of 
automobiles), a service (building maintenance), or some combination of the 
two (the construction of a building). 

A vast network of goods and services contracts spans the working world. 
The U.S. government, the world’s biggest customer, spent $327 billion in 2009 
buying military equipment from organizations that submitted proposals (U.S. 
Department of Defense, 2013). But goods and services contracts are by no 
means limited to government contractors. An auto manufacturer might buy 
its engines from another manufacturer; a company that makes spark plugs 
might buy its steel and other raw materials from another company. 

Another kind of goods and services proposal requests funding to support a 
local organization. For example, a women’s shelter might receive some of its 
funding from a city or county but might rely on grants from private philan- 
thropies. Typically, an organization such as a shelter would apply for a grant 
to fund increased demand for its services due to a natural disaster or an eco- 
nomic slowdown in the community. Or it might apply for a grant to fund a 
pilot program to offer job training at the shelter. Most large corporations have 
philanthropic programs offering grants to help local colleges and universi- 
ties, arts organizations, and social-service agencies. 
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Persuasion and Proposals 

A proposal is an argument. You must convince readers that the future ben- 
efits will outweigh the immediate and projected costs. Basically, you must 
persuade your readers of three things: 

• that you understand their needs 

• that you have already determined what you plan to do and that you are 
able to do it 

• that you are a professional and are committed to fulfilling your promises 

UNDERSTANDING READERS' NEEDS 

The most crucial element of the proposal is the definition of the problem or 
opportunity to which the proposed project responds. Although this point 
seems obvious, people who evaluate proposals agree that the most common 
weakness they see is an inadequate or inaccurate understanding of the prob- 
lem or opportunity. 

Readers' Needs in an Internal Proposal Writing an internal proposal is 
both simpler and more complicated than writing an external one. It is simpler 
because you have greater access to internal readers than you do to external 
readers and you can get information more easily. However, it is more compli- 
cated because you might find it hard to understand the situation in your orga- 
nization. Some colleagues will not tell you that your proposal is a long shot or 
that your ideas might threaten someone in the organization. Before you write 
an internal proposal, discuss your ideas with as many potential readers as you 
can to learn what those in the organization really think of them. 

Readers' Needs in an External Proposal When you receive an RFP, 
study it thoroughly. If you don’t understand something in it, contact the orga- 
nization. They will be happy to clarify it: a proposal based on misunderstood 
needs wastes everyone’s time. 

When you write an unsolicited proposal, analyze your audience carefully. 
How can you define the problem or opportunity so that readers will under- 
stand it? Keep in mind readers’ needs and, if possible, their backgrounds. 
Concentrate on how the problem has decreased productivity or quality 
or how your ideas would create new opportunities. When you submit an 
unsolicited proposal, your task in many cases is to convince readers that a 
need exists. Even if you have reached an understanding with some of your 
potential customer’s representatives, your proposal will still have to persuade 
other officials in the company. Most readers will reject a proposal as soon as 
they realize that it doesn’t address their needs. 

When you are preparing a proposal to be submitted to an organization in 
another culture, keep in mind the following six suggestions (Newman, 2011): 

• Understand that what makes an argument persuasive can differ from one 
culture to another. Paying attention to the welfare of the company or the 


For more about persuasion, see Ch. 8. 


For more about analyzing your 
audience, see Ch. 5 . 
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For more about graphics, see Ch. 1 2. 


community might be more persuasive than offering a low bottom-line 
price. Representatives of an American company were surprised to learn 
that the Venezuelan readers of their proposal had selected a French 
company whose staff “had been making personal visits for years, bringing 
their families, and engaging in social activities long before there was any 
question of a contract” (Thrush, 2000). 

• Budget enough time for translating. If your proposal has to be translated 
into another language, build in plenty of time. Translating long technical 
documents is a lengthy process because, even though some of the work 
can be done by computer software, the machine translation needs to be 
reviewed by native speakers of the target language. 

• Use simple graphics, with captions. To reduce the chances of misunderstand- 
ing, use a lot of simple graphics, such as pie charts and bar graphs. Include 
captions so that readers can understand the graphics easily, without having 
to look through the text to see what each graphic means. 

• Write short sentences, using common vocabulary. Short sentences are 
easier to understand than long sentences. Choose words that have few 
meanings. For example, use the word right as the opposite of left ; use 
correct as the opposite of incorrect. 

• Use local conventions regarding punctuation, spelling, and mechanics. 

Be aware that these conventions differ from place to place, even in the 
English-speaking world. 

• Ask if the prospective customer will do a read-through. A read-through is the 
process of reading a draft of a proposal to look for any misunderstandings 
due to language or cultural differences. Why do prospective customers do 
this? Because it’s in everyone’s interest for the proposal to respond clearly 
to the customer’s needs. 

DESCRIBING WHAT YOU PLAN TO DO 

Once you have shown that you understand what needs to be done and why, 
describe what you plan to do. Convince your readers that you can respond 
effectively to the situation you have just described. Discuss procedures and 
equipment you would use. If appropriate, justify your choices. For example, if 
you say you want to do ultrasonic testing on a structure, explain why, unless 
the reason is obvious. 

Present a complete picture of what you would do from the first day of the 
project to the last. You need more than enthusiasm and good faith; you need a 
detailed plan showing that you have already started to do the work. Although 
no proposal can anticipate every question about what you plan to do, the 
more planning you have done before you submit the proposal, the greater the 
chances you will be able to do the work successfully if it is approved. 

DEMONSTRATING YOUR PROFESSIONALISM 

Once you have shown that you understand readers’ needs and can offer a well- 
conceived plan, demonstrate that you are the kind of person (or that yours is the 
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kind of organization) that is committed to delivering what you promise. Con- 
vince readers that you have the pride, ingenuity, and perseverance to solve the 
problems that are likely to occur. In short, show that you are a professional. 


4 \ 


GUIDELINES 


Demonstrating Your 
Professionalism in a Proposal 


In your proposal, demonstrate your ability to carry out the project by providing four 
kinds of information: 


► Credentials and work history. Show that you know how to do this project be- 
cause you have done similar ones. Who are the people in your organization with 
the qualifications to carry out the project? What equipment and facilities do you 
have that will enable you to do the work? What management structure will you 
use to coordinate the activities and keep the project running smoothly? 

► Work schedule. Sometimes called a task schedule, a work schedule is a graph or 
chart that shows when the various phases of the project will be carried out. The 
work schedule reveals more about your attitudes toward your work than about 
what you will be doing on any given day. A detailed work schedule shows that 
you have tried to foresee problems that might threaten the project. 

► Quality-control measures. Describe how you will evaluate the effectiveness and 
efficiency of your work. Quality-control procedures might consist of technical 
evaluations carried out periodically by the project staff, on-site evaluations by 
recognized authorities or by the prospective customer, or progress reports. 

► Budget. Most proposals conclude with a detailed budget, a statement of how 
much the project will cost. Including a budget is another way of showing that 
you have done your homework on a project. 


ETHICS NOTE 


WRITING HONEST PROPOSALS 

When an organization approves a proposal, it needs to trust that the people who will carry out 
the project will do it professionally. Over the centuries, however, dishonest proposal writers 
have perfected a number of ways to trick prospective customers into thinking the project will 
go smoothly: 

• saying that certain qualified people will participate in the project, even though they will not 

• saying that the project will be finished by a certain date, even though it will not 

• saying that the deliverable will have certain characteristics, even though it will not 

• saying that the project will be completed under budget, even though it will not 
Copying from another company's proposal is another common dishonest tactic. Proposals are 
protected by copyright law. An employee may not copy from a proposal he or she wrote while 
working for a different company. 

There are three reasons to be honest in writing a proposal: 

• to avoid serious legal trouble stemming from breach-of-contract suits 

• to avoid acquiring a bad reputation, thus ruining your business 

• to do the right thing 







428 


16 


WRITING PROPOSALS 


For more about collaboration, see 
Ch. 4. 


For more about boilerplate, see 
Ch. 2, p. 26. 


Writing a Proposal 

Although writing a proposal requires the same writing process that you use 
for most other kinds of technical documents, a proposal can be so large that 
two aspects of the writing process — resource planning and collaboration — are 
even more important than they are for smaller documents. 

Like planning a writing project, discussed in Chapter 5, planning a pro- 
posal requires a lot of work. You need to see whether your organization can 
devote the needed resources to writing the proposal and then to carrying out 
the project if the proposal is approved. Sometimes an organization writes 
a proposal, wins the contract, and then loses money because it lacks the 
resources to do the project and must subcontract major portions of it. The 
resources you need fall into three basic categories: 

• Personnel. Will you have the technical personnel, managers, and support 
people you will need? 

• Facilities. Will you have the facilities, or can you lease them? Can you 
profitably subcontract tasks to companies that have the necessary 
facilities? 

• Equipment. Do you have the right equipment? If not, can you buy it or 
lease it or subcontract the work? Some contracts provide for the purchase 
of equipment, but others don’t. 

Don’t write the proposal unless you are confident that you can carry out the 
project if you get the go-ahead. 

Collaboration is critical in preparing large proposals because no one per- 
son has the time and expertise to do all the work. Writing major proposals 
requires the expertise of technical personnel, writers, editors, graphic artists, 
managers, lawyers, and document-production specialists. Often, proposal 
writers use shared document workspaces and wikis. Usually, a project man- 
ager coordinates the process. 

Proposal writers almost always reuse existing information, including boil- 
erplate such as descriptions of other projects the company has done, histories 
and descriptions of the company, and resumes of the primary personnel who 
will work on the project. This reuse of information is legal and ethical as long 
as the information is the intellectual property of the company. 


The Structure of the Proposal 

Proposal structures vary greatly from one organization to another. A long, 
complex proposal might have 10 or more sections, including introduction, 
problem, objectives, solution, methods and resources, and management. If 
the authorizing agency provides an IFB, an RFP, an RFQ, or a set of guidelines, 
follow it closely. If you have no guidelines, or if you are writing an unsolicited 
proposal, use the structure shown here as a starting point. Then modify it 
according to your subject, your purpose, and the needs of your audience. An 
example of a proposal is presented on pages 436-42. 
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SUMMARY 

For a proposal of more than a few pages, provide a summary. Many organiza- 
tions impose a length limit — such as 250 words — and ask the writer to pre- 
sent the summary, single-spaced, on the title page. The summary is crucial, 
because it might be the only item that readers study in their initial review of 
the proposal. 

The summary covers the major elements of the proposal but devotes 
only a few sentences to each. Define the problem in a sentence or two. Next, 
describe the proposed program and provide a brief statement of your qualifi- 
cations and experience. Some organizations wish to see the completion date 
and the final budget figure in the summary; others prefer that this informa- 
tion be presented separately on the title page along with other identifying 
information about the supplier and the proposed project. 

INTRODUCTION 

The purpose of the introduction is to help readers understand the context, 
scope, and organization of the proposal. 
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Introducing a Proposal 


The introduction to a proposal should answer the following seven questions: 


► What is the problem or opportunity? Describe the problem or opportunity in 
specific monetary terms, because the proposal itself will include a budget, and 
you want to convince your readers that spending money on what you propose is 
smart. Don't say that a design problem is slowing down production; say that it is 
costing $4,500 a day in lost productivity. 

► What is the purpose of the proposal? The purpose of the proposal is to describe 
a solution to a problem or an approach to an opportunity and propose activities 
that will culminate in a deliverable. Be specific in explaining what you want to do. 

► What is the background of the problem or opportunity? Although you probably 
will not be telling your readers anything they don't already know, show them that 
you understand the problem or opportunity: the circumstances that led to its 
discovery, the relationships or events that will affect the problem and its solution, 
and so on. 

► What are your sources of information? Review the relevant literature, ranging 
from internal reports and memos to published articles or even books, so that 
readers will understand the context of your work. 

► What is the scope of the proposal? If appropriate, indicate not only what you are 
proposing to do but also what you are not proposing to do. 

► What is the organization of the proposal? Explain the organizational pattern you 
will use. 

► What are the key terms that you will use in the proposal? If you will use any 
specialized or unusual terms, define them in the introduction. 


For more about summaries, see 
Ch. 18, p. 483. 
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For more about researching a 
subject, see Ch. 6. 


PROPOSED PROGRAM 

In the section on the proposed program, sometimes called the plan of work, 
explain what you want to do. Be specific. You won’t persuade anyone by say- 
ing that you plan to “gather the data and analyze it.” How will you gather and 
analyze the data? Justify your claims. Every word you say — or don’t say — will 
give your readers evidence on which to base their decision. 

If your project concerns a subject written about in the professional litera- 
ture, show your familiarity with the scholarship by referring to the pertinent 
studies. However, don’t just string together a bunch of citations. For exam- 
ple, don’t write, “Carruthers (2012), Harding (2013), and Vega (2013) have all 
researched the relationship between global warming and groundwater con- 
tamination.” Rather, use the recent literature to sketch the necessary back- 
ground and provide the justification for your proposed program. For instance: 

Carruthers (2012), Harding (201 3), and Vega (201 3) have demonstrated the 
relationship between global warming and groundwater contamination. None of 
these studies, however, included an analysis of the long-term contamination of the 
aquifer. The current study will consist of 

You might include only a few references to recent research. However, if your 
topic is complex, you might devote several paragraphs or even several pages 
to recent scholarship. 

Whether your project calls for primary research, secondary research, or 
both, the proposal will be unpersuasive if you haven’t already done a sub- 
stantial amount of research. For instance, say you are writing a proposal to do 
research on purchasing new industrial-grade lawn mowers for your company. 
Simply stating that you will visit Wal-Mart, Lowe’s, and Home Depot to see 
what kinds of lawn mowers they carry would be unpersuasive for two reasons: 

• You need to justify why you are going to visit those three retailers rather 
than others. Anticipate your readers’ questions: Why did you choose these 
three retailers? Why didn’t you choose specialized dealers? 

• You should already have determined what stores carry what kinds of 
lawn mowers and completed any other preliminary research. If you 
haven’t done the homework, readers have no assurance that you will in 
fact do it or that it will pay off. If your supervisor authorizes the project 
and then you learn that none of the lawn mowers in these stores meets 
your organization’s needs, you will have to go back and submit a different 
proposal — an embarrassing move. 

Unless you can show in your proposed program that you have done 
the research — and that the research indicates that the project is likely to 
succeed — the reader has no reason to authorize the project. 


QUALIFICATIONS AND EXPERIENCE 

After you have described how you would carry out the project, show that you 
can do it. The more elaborate the proposal, the more substantial the discussion 
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DOCUMENT ANALYSIS ACTIVITY 


Writing the Proposed Program 

The following project description is excerpted from a sample grant proposal seeking funding to begin a project to help police officers 
stay healthy (Ohio Office of Criminal Justice Services, 2003). The questions in the margin ask you to think about how to describe the 
project in a proposal. 


1 . The writer has used a letter- 
ing system to describe the 
four main tasks that will be 
undertaken if the project 
receives funding. What are 
the advantages of a lettering 
system? 

2 . How effective is the 
description of Task A? What 
factors contribute to the 
description's effectiveness or 
lack of effectiveness? 

3 . The descriptions of the tasks 
do not include cost esti- 
mates. Where would those 
estimates be presented in 
the proposal? Why would 
they be presented there? 

4 . How effective is the descrip- 
tion of Task D? What addi- 
tional information would 
improve its effectiveness? 


PROJECT DESCRIPTION 

The proposed project is comprised of several different, but related activities: 

A. Physical Evaluation of the Officers 

The first component of this project is the physical examination of all 
Summerville P.D. sworn employees. Of special interest for purposes of 
the project are resting pulse rate, target pulse rate, blood pressure, and 
percentage of body fat of the program participants. Dr. Fein berg will perform 
the physical examinations of all participating officers. The measurement of 
body fat will be conducted at the University of Summerville's Health Center 
under the direction of Dr. Farron Updike. 

B. Renovation of Basement 

Another phase of this project involves the renovation of the basement of 
police headquarters. The space is currently being used for storing Christmas 
decorations for City Hall. 

The main storage room will be converted into a gym. This room will 
accommodate the Universal weight machine, the stationary bike, the 
treadmill and the rowing machine. Renovation will consist of first transferring 
all the Christmas decorations to the basement of the new City Hall. Once that 
is accomplished, it will be necessary to paint the walls, install indoor/outdoor 
carpeting and set up the equipment. 

A second, smaller room will be converted into a locker room. Renovation will 
include painting the floors and the installation of lockers and benches. 

To complete the fitness center, a third basement room will be equipped as a 
shower room. A local plumber will tap into existing plumbing to install several 
showerheads. 

C. Purchase of Fitness Equipment 

The Department of Public Safety has identified five vendors of exercise 
equipment in the greater Summerville area. Each of these vendors submitted 
bids for the following equipment: 

• Universal Weight Machine 

• Atlas Stationary Bike 

• Yale Rowing Machine 

• SpeedsterTreadmill 

D. Training of Officers 

Participating officers must be trained in the safe, responsible use of the 
exercise equipment. Dr. Updike of the University of Summerville will hold 
periodic training sessions at the Department's facility. 


Source: Ohio Office of Criminal Justice Services, 2003. 





432 


16 


WRITING PROPOSALS 


DOCUMENT ANALYSIS ACTIVITY 


To analyze a proposal delivered as a Prezi presentation, 
go to "Document Analysis Activities" under "Additional 
Resources" in Ch. 16: macmillanhighered.com/launchpad 
/techcommlle. 



Marketing Proposal Presentation 

Used by permission of Andrew Washuta. 


of your qualifications and experience has to be. For a small project, include 
a few paragraphs describing your technical credentials and those of your co- 
workers. For larger projects, include the resumes of the project leader, often 
called the principal investigator, and the other primary participants. 

External proposals should also discuss the qualifications of the supplier’s 
organization, describing similar projects the supplier has completed success- 
fully. For example, a company bidding on a contract to build a large suspen- 
sion bridge should describe other suspension bridges it has built. It should 
also focus on the equipment and facilities the company already has and on 
the management structure that will ensure the project will go smoothly. 

BUDGET 

Good ideas aren’t good unless they’re affordable. The budget section of a pro- 
posal specifies how much the proposed program will cost. 

Budgets vary greatly in scope and format. For simple internal proposals, 
add the budget request to the statement of the proposed program: “This 
study will take me two days, at a cost of about $400” or “The variable-speed 
recorder currently costs $225, with a 10 percent discount on orders of five or 
more.” For more-complicated internal proposals and for all external propos- 
als, include a more-explicit and complete budget. 

Many budgets are divided into two parts: direct costs and indirect costs. 
Direct costs include such expenses as salaries and fringe benefits of program 
personnel, travel costs, and costs of necessary equipment, materials, and 
supplies. Indirect costs cover expenses that are sometimes called overhead: 
general secretarial and clerical expenses not devoted exclusively to any one 
project, as well as operating expenses such as costs of utilities and mainte- 
nance. Indirect costs are usually expressed as a percentage — ranging from 
less than 20 percent to more than 100 percent — of the direct expenses. 

APPENDIXES 

Many types of appendixes might accompany a proposal. Most organizations 
have boilerplate descriptions of the organization and of the projects it has com- 
pleted. Another item commonly included in an appendix is a supporting letter: 
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a testimonial to the supplier’s skill and integrity, written by a reputable and 
well-known person in the field. Two other kinds of appendixes deserve special 
mention: the task schedule and the description of evaluation techniques. 

Task Schedule A task schedule is almost always presented in one of three 
graphical formats: as a table, a bar chart, or a network diagram. 

Tables The simplest but least informative way to present a schedule is 
in a table, as shown in Figure 16.3. As with all graphics, provide a textual 
reference that introduces and, if necessary, explains the table. 


TASK SCHEDULE 


Activity 

Start date 

Finish date 

Design the security system 

4 Oct. 14 

19 Oct. 14 

Research available systems 

4 Oct. 14 

3 Jan. 15 

Etc. 


FIGURE 16.3 Task Schedule Presented as a Table 


Although displaying information in a table is better than writing it out 
in sentences, readers still cannot “see” the information. They have to read 
the table to figure out how long each activity will last, and they cannot 
tell whether any of the activities are interdependent. They have no way of 
determining what would happen to the overall project schedule if one of the 
activities faced delays. 

Bar Charts Bar charts, also called Gantt charts after the early twentieth- 
century civil engineer who first used them, are more informative than tables. 
The basic bar chart shown in Figure 16.4 allows readers to see how long each 
task will take and whether different tasks will occur simultaneously. Like 
tables, however, bar charts do not indicate the interdependence of tasks. 


Schedule for Parking Analysis Project 



FIGURE 16.4 Task Schedule Presented as a Bar Chart 
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TECH TIP 


HowTo Create a Gantt Chart 

If you want to show how activities occur over time, you can 
create a simple Gantt chart using the Table feature in Word. 

1 . Create a table with enough cells to include your tasks 
and dates. 


Task 








Task 1: Review Policies 








Task 2: Research Trends 








Task 3: Identify Criteria 








Task 4: Interview Experts 








Task 5: Evaluate Options 








Task 6: Prepare Report 









24 

31 

1 

7. 

12 

19 

22 











M 


' Enter the tasks in rows. 

Enter the dates in columns. 

If you need to add or 
remove rows or columns, 
you can use the buttons 
in the Rows & Columns 
group on the TableTools 
Layout tab. 

2. To create cells that span several 
columns, select the cells you wish 
to merge, right-click, and then 
select Merge Cells on the 
pop-up menu. 

To create column headings, first 
merge the cells that will contain 
the column heading. Then type 
in your heading in the expanded 
cell. To add a horizontal rule below 
the heading, select the cell that 
contains it and choose Borders and 
Shading from the Format tab. 


^ Insert Below 

-30 Insert Left 
Insert _ 

Above Sir Insert Right 
• Rows & Columns n 


* Cut 
liS Copy 

ifi Paste Options: 

IBS® 

Insert 

fie let e Cells... 
Select 

ir*J Merge Cells 


fiorders and Shading... 
Tejt Direction.,. 

Cell Alignment 
iutofit 

Table P[operties... 


3. To differentiate completed tasks 
(dark bars) from tasks yet to be 
completed (lighter bars) or to hide 
borders, select the cells you wish 
to modify and then choose the 
Borders button on the Table - 
Tools Design tab. Then select 
Borders and Shading. 

The Borders and Shading 

dialog box will appear. 


Design Layout 


^Shading * 



! Bordets 1 • 

Wpt 

• 


Bottom Border 
Tofl Border 
[ ; | Lett Border 
3| Right Border 
iT! fio Border 
EBl £11 Borders 
(□) Outride Borders 
Inside Borders 
[•— ] Inside Horizontal Border 
Hfj] Inside Yertical Border 
N; Diagonal Doyyn Border 
'tf\ Diagonal fip Border 
Jr Honjontal Line 
gf fir aw Table 
(Ta^ view findlines 
£J Borders and Shading... 



The Shading tab allows 
you to shade selected 
cells. 



Task 

\ \ Dates of Tasks 

Task 1: Review Policies 






Task 2: Research Trends 







Task 3: Identify Criteria 







Task 4: Interview Experts 







Task 5: Evaluate Options 








Task 6: Prepare Report 








24 

31 

1 

8 

15 

19 | 22 


March 

April 


KEYWORDS: table, cells, merge cells, borders, shading 
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Finalize the design Produce the diagrams 




10 


Research the HVAC systems 



Activity 


Lease the equipment Install the system 



15 


Develop the 
team plan 


Select the 
team leader 


Hire 3 Train 
workers workers 

' -i-0 - I 


Establish work 
procedures 


Approximate length 
of time (in days) 


FIGURE 16.5 Task 
Schedule Presented as 
a Network Diagram 

A network diagram provides more 
useful information than either a 
table or a barchart. 


Network Diagrams Network diagrams show interdependence among various 
activities, clearly indicating which must be completed before others can 
begin. However, even a relatively simple network diagram, such as the one 
shown in Figure 16.5, can be difficult to read. You would probably not use this 
type of diagram in a document intended for general readers. 

Description of Evaluation Techniques Although evaluation can mean 
different things to different people, an evaluation technique typically refers 
to any procedure used to determine whether the proposed program is both 
effective and efficient. Evaluation techniques can range from writing simple 
progress reports to conducting sophisticated statistical analyses. Some pro- 
posals call for evaluation by an outside agent, such as a consultant, a testing 
laboratory, or a university. Other proposals describe evaluation techniques 
that the supplier will perform, such as cost-benefit analyses. 

The issue of evaluation is complicated by the fact that some people think in 
terms of quantitative evaluations — tests of measurable quantities, such as pro- 
duction increases — whereas others think in terms of qualitative evaluations — 
tests of whether a proposed program is improving, say, the workmanship on 
a product. And some people include both qualitative and quantitative testing 
when they refer to evaluation. An additional complication is that projects can 
be tested while they are being carried out (formative evaluations) as well as after 
they have been completed ( summative evaluations). 

When an RFP calls for “evaluation,” experienced proposal writers contact 
the prospective customer’s representatives to determine precisely what the 
word means. 


Sample Internal Proposal 

The following example of an internal proposal has been formatted as a 
memo rather than as a formal proposal. (See Chapter 17, pp. 454-61, for the 
progress report written after this project was under way and Chapter 18, 
pp. 488-511, for the recommendation report.) 
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In most professional settings, 
writers use letterhead stationery 
for memos. 

Proposals can be presented as 
memos or as reports. Memos are 
more popular for brief documents 
(fewer than five pages), whereas 
reports are more popular for longer 
documents. 

The writers include their titles and 
that of their primary reader. This 
way, future readers will be able 
to readily identify the reader and 
writers. 

The subject heading indicates the 
subject of the memo (the tablet 
study at Rawlings Regional Medical 
Center) and the purpose of the 
memo (proposal). 

As discussed in Ch. 14, memos of 
more than one page should begin 
with a clear statement of purpose. 
Here, the writers communicate the 
primary purpose of the document 
in one sentence. 

Memos of more than one page 
should contain a summary to serve 
as an advance organizer or to help 
readers who want only an overview 
of the document. 

Although the writers are writing 
to Dr. Bremerton, they refer to her 
in the third person to suggest the 
formality of their relationship. 

The background of the problem. 
Don't assume that your reader 
knows what you are discussing, 
even if it was the reader who 
suggested the project in the first 
place. 


Rawlings Regional Medical Center 
7500 Bannock Avenue 
Rawlings, MT 59211 


Date: October 6, 201 3 

To: Jill 8remerton, M.D. 

Chief Executive Officer 
Rawlings Regional Medical Center 
From: Jeremy Eikins, Director of Information Technology 

Eloise Carruthers, Director of Nursing 
Rawlings Regional Medical Center 
Subject—® Proposal for the Tablet Study at RRMC 

Purpose 

The purpose of our proposal is to request authorization to conduct 
a study to determine the best course of action for integrating tablet 
computers into the RRMC clinical setting. 

Summary 

On September 1 6, 201 3, Dr. Jill Bremerton, RRMC Chief Executive 
Officer, asked us to deveiop a plan to study national trends on tablet 
use, determine clinical-staff knowledge of and attitudes toward tablets, 
examine administrative models for tablet use, devise criteria for assessing 
tablets, and present our findings, including a recommendation. 

Currently, RRMC has no formal policy on tablet usage by clinical staff. By 
default, we are following a bring-your-own-device (BYOD) approach. More 
than half of our clinical staff use their personal tablets in their work. This 
situation is not ideal because not all clinical staff are taking advantage of 
the enormous potential for improving patient care and reducing costs 
by using tablets, and IT is struggling to keep up with the work needed 
to ensure that all the different tablets are working properly and that 
information-security protocols required by HIPAA and the Affordable Care 
Act are not being violated. 




The problem at the heart of the 
project. 
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Memo to Jill Bremerton, M.D. October 6, 201 3 Page 2 

Therefore, Dr. Bremerton wanted us to determine the best approach to 
making tablets available to all our clinical staff. Specifically, Dr. Bremerton 
asked that we develop a plan to determine how tablets are being used by 
clinical staff across the nation, determine the RRMC clinical staff's current 
knowledge of and attitudes toward tablet use, determine how hospitals 
administer the use of tablets in a clinical setting, establish criteria by 
which we might evaluate tablets for RRMC, and assess available tablets 
based on our criteria. 

We propose to research tablet use in clinical settings and present our 
findings to Dr. Bremerton. To perform these tasks, we would carry out 
secondary and primary research. We would study the literature on tablet 
use, distribute a questionnaire to RRMC clinical staff, and interview Dr. 
Bremerton. Then, we would collect and analyze our data and write the 
report. 

To perform this research and present a recommendation report, we 
estimate that we would each require approximately 40 hours over 
the next two months, at a cost of $2,680. Jeremy Elkins, Director of 
Information Technology, has been with RRMC for 9 years and has overseen 
numerous IT feasibility studies. Eloise Carruthers has been with RRMC for 
1 3 years, the last 8 of which have been as Director of Nursing. 

If this proposal is authorized, we would begin our research immediately, 
submitting to Dr. Bremerton a progress report on November 14, 2013, and 
a recommendation report on December 14, 201 3. The recommendation 
report would include the details of our research and recommendations 
regarding how to proceed with the feasibility study. 

Introduction 

On September 1 6, 2013, Dr. Jill Bremerton, RRMC Chief Executive Officer, 
asked us to develop a plan to determine the best course of action for 
integrating tablet computers into the RRMC clinical setting. 

Currently, RRMC has no formal policy on tablet usage by clinical staff. By 
default, we are following a bring-your-own-device (BYOD) approach. More 
than half of our clinical staff use their personal tablets in their work. This 
situation is not ideal because not all clinical staff are taking advantage of 
the enormous potential for improving patient care and reducing costs 


The proposal. The writers have 
already begun to plan what they 
will do if the proposal is accepted, 
but they use the conditional tense 
("would") because they cannot 
assume that their proposal will be 
approved. 

A summary of the schedule and the 
credentials of the writers. Because 
the reader will likely want to read 
this entire proposal, the summary 
functions as an advance organizer. 


A brief statement of the context for 
the proposal. 


An explanation of the problem: 
the current situation is inadequate 
because the medical center is not 
taking full advantage of tablets 
and because IT is spending a lot of 
time ensuring that the tablets in 
use are in compliance with federal 
requirements. 


This same paragraph appeared 
in the "Summary” section of the 
proposal. In technical communica- 
tion, writers often present the same 
information several times because 
some readers will read only selected 
portions of the document. 
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The writers paraphrase text from a 
memo Dr. Bremerton had written to 
them. Often in technical communi- 
cation, you will quote or paraphrase 
your reader's words to remind him 
or her of the context and to show 
that you are carrying out your tasks 
professionally — and to give the 
reader the opportunity to change 
the direction of the study before it 
officially begins. 

The introduction concludes with an 
advance organizer for the rest of the 
proposal. 

By presenting the project as a set of 
tasks, the writers show that they are 
well organized. This organization by 
tasks will be used in the progress 
report (see Ch. 1 7, pp. 454-61 ) and 
the recommendation report (see 
Ch. 18, pp. 488-511). 


Memo to Jill Bremerton, M.D. October 6, 201 3 Page 3 

by using tablets, and IT is struggling to keep up with the work needed 
to ensure that all the different tablets are working properly and that 
information-security protocols required by HiPAA and the Affordable Care 
Act are not being violated. 

Therefore, Dr. Bremerton wanted us to determine the best approach to 
making tablets available to all our clinical staff. Specifically, Dr. Bremerton 
asked that we develop a plan to perform five tasks: 

• Determine how tablets are being used by clinical staff across the nation. 

• Determine the RRMC clinical staff's current knowledge of and attitudes 
toward tablet use. 

• Determine how hospitals administer the use of tablets in a clinical setting. 

• Establish criteria by which we might evaluate tablets for RRMC. 

• Assess available tablets based on our criteria. 

In the following sections, we provide additional details about the 
proposed tasks, schedule, and budget, as well as our credentials and 
references. 

Proposed Tasks 

With Dr. Bremerton's approval, we would perform the following six tasks to 
help determine the best course of action for integrating tablet computers 
into the RRMC clinical setting. 

• Task 1 . Acquire a basic understanding of tablet use by clinical staff across 

the nation 

We have already begun our research by interviewing Dr. Bremerton, who 
emphasized that we need to maintain our focus on our priorities — patient 
care and service to the community — and not let technical questions about 
the tablets distract us from the needs of our clinical staff. "We're not going 
to do anything without the approval of the doctors and nurses," she said. 

We also discovered an article that corroborated what Dr. Bremerton had 
told us (Narisi, 201 3). Two keys to doing the research were to focus on 
security features — data-privacy issues mandated in HIPAA and in the 
Affordable Care Act — and to get the clinical staff's input. 
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Memo to Jill Bremerton, M.D. October 6, 201 3 


Page 4 


Dr. Bremerton pointed us to a number of resources on tablet use in clinical 
settings. In addition, we have begun to conduct our own literature review. 
Most of the research we studied falls into one of four categories: 

• general introductions to tablet use in trade magazines and general- 
interest periodicals 

• more-focused articles about tablets used in health care 

• technical specifications of tablets provided in trade magazines and on 
manufacturers' websites 

• trade-magazine articles about best practices for managing the use of 
tablets in clinical settings 

As we expected, the information we acquired is a mix of user opinions, 
benchmark-test results, and marketing. We would rely most heavily on 
case studies from hospital administrators and technical specialists in 
health IT. Because of the unreliability of information on manufacturers' 
websites, we are hesitant to rely on claims about product performance. 


The proposal sounds credible 
because the writers have already 
begun their secondary research. 
Readers are reluctant to approve 
proposals unless they are sure that 
the writers have at least begun their 
research. 


Following the recommendation 
from Dr. Bremerton, the writers start 
by outlining the secondary research 
they plan to do. The logic is obvi- 
ous: if they are to present sensible 
recommendations, they need to 
understand their subject. 


Task 2: Determine the RRMC clinical staff's knowledge of and attitudes 
toward tablet use 

Next week, we propose to send all clinical staff members an email linking 
to a four-question Qualtrix survey. The email would explain that we were 
seeking opinions about tablet use by clinical-staff members who already 
own tablets and would make clear that the survey would take less than 
two minutes to complete. 


By stating that they know that their 
sources are a mixture of different 
kinds of information, not all of 
which are equally useful for every 
kind of question that needs to be 
answered, the writers suggest that 
they are careful analysts. 


Task 3. Assess the BYOD and hospital-owned tablet models 
Our research has already revealed that hospitals currently use one of 
two models for giving clinical staff access to tablets: the bring-your-own- 
device (BYOD) approach and purchasing tablets to distribute to staff. We 
have found literature that assesses the advantages and disadvantages of 
each of these models (Jackson, 201 1 a, 201 1 b). 

For statistics on the popularity of each of these administrative models, we 
would rely on a survey (Terry, 2011). 


The writers show that they have 
applied the insights they gathered 
from their secondary research. 
Now they propose doing primary 
research to determine whether 
the RRMC clinical staff share the 
attitudes of clinical staff across the 
country. The logic is clear: if they 
do, the hospital administrators 
will know that they can rely on the 
national data. 


The writers cite their sources 
throughout the proposal. 
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Often you will begin your project 
with a cost criterion: your recom- 
mended solution must not cost 
more than a certain amount. 


Preparing the recommendation 
report is part of the project because 
the report is the deliverable. 


Memo to Jill Bremerton, M.D. October 6, 201 3 Page 5 

Task 4: Establish criteria for evaluating tablets 

We (Jeremy Elkins and Eloise Carruthers) have both begun to study the 
voluminous literature on tablets. Jeremy Elkins has met informally with 
his five IT colleagues to discuss the data, and Eloise Carruthers has met 
informally with her nursing staff and with selected physicians, including 
several who already own tablets and use them in the clinic. 

We would begin with the first criterion: cost. Dr. Bremerton told us in our 
interview that the budget for the project (assuming that RRMC would 
supply a tablet to each member of the clinical staff) would be $800 per 
device, fully configured with any commercial software needed to operate 
it. For this reason, we would not thoroughly examine any tablets that do 
not meet this criterion. 

In addition, we would pay particular attention to the complexities of the 
current tablet market, focusing on whether the various devices would 
work seamlessly with our health-records system and other security 
features ("Top Five," 201 3), on the need to be able to disinfect the tablets 
(Carr, 201 1), and on durability (Narisi, 201 3). Furthermore, we know from 
experience with all kinds of portable information technology that the 
question of battery life would be problematic because it can vary so much 
depending on load and other factors. 

We anticipate that two factors might be critically important: operating 
system and availability of relevant apps. 

Task S. Assess available tablets based on our criteria 
We would begin our study of the tablets by examining trade magazines. 
We realize, however, that several of our likely criteria — namely, the ability 
to disinfect the tablet, as well as durability and battery life — might not be 
addressed adequately in the literature because each hospital has its own 
specific needs. If the literature cannot help us complete our assessments, 
we would need to carry out on-site evaluations at RRMC. 

Task 6. Analyze our data and prepare a recommendation report 
We would draft our recommendation report and upload it to a wiki 
to make it convenient for the other IT staff members and interested 
clinical staff members to help us revise it. We would then incorporate our 
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Page 6 


colleagues'suggestions and present a final draft of the report on the wiki 
to gather any final editing suggestions. 

Schedule 

Figure 1 is a schedule of the tasks we would complete for this project. 


Tasks 

Date of Tasks (by Weeks) 

Task 1: Research tablet 
use 









Task 2: Determine staff 
knowledge and attitudes 









— 


Task 3: Research 
management models 











Task 4: Establish criteria 











Task 5: Assess tablets 
based on criteria 










Task 6: Prepare report 








28 5 12 


10 

17 

24 

31 

7 

14 

21 


Oct. 

Nov. Dec. 


Figure 1. Schedule of Project Tasks 

Budget 

Following is an itemized budget for our proposed research. 


Name 

Hours 

Hourly 
rate ($) 

Cost ($) 

Jeremy Elkins 

40 

28 

1,120 

Eloise Carruthers 

40 

39 

1,560 

Total: $2,680 


Organizing the project by tasks 
makes it easy for the writers to 
present a Gantt chart. In addition, 
the task organization will help the 
writers stay on track if the proposal 
is approved and they continue their 
research. 

Each task is presented with parallel 
grammar, which shows that the 
writers are careful and professional. 

Some tasks overlap in time: 
researchers often work on several 
tasks simultaneously. 

The Tech Tip on p. 434 explains how 
to create a Gantt chart. 
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The writers summarize their 
credentials. Strong credentials help 
reinforce the writers' professional- 
ism. 


This list of references follows the 
APA documentation style, which 
is discussed in Appendix, Part B, 
p. 616. The APA documentation 
system calls for References to begin 
on a new page. Check with your 
instructor. 


Memo to Jill Bremerton, M.D. October 6, 201 3 Page 7 

• Experience 

We are experienced professionals who have participated in numerous 
studies both here at RRMC and elsewhere. 

• Jeremy Elkins, Director of Information Technology, has chaired the 
Technology Infrastructure Committee and served as ad hoc member 
of the Steering Committee at RRMC for 9 years. He has designed 
the current IT infrastructure at RRMC, oversees the purchase of all IT 
equipment, and is currently implementing RRMC's electronic health 
records software. 

• Eloise Carruthers, Director of Nursing at RRMC, holds bachelor's and 
master's degrees in nursing and has earned over 1 00 CEUs in virtually 
every aspect of the profession, including budgeting and management. 
She has administrative responsibility for all the registered and licensed 
nurses, as well as all nursing assistants. She has provided leadership in 
every aspect of patient care at RRMC for the last 1 3 years. 
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WRITER'S CHECKLIST 


The following checklist covers the basic elements of a 
proposal. Guidelines established by the recipient of the 
proposal should take precedence over these general 
suggestions. 

Does the summary provide an overview of 
DD the problem or the opportunity? (p. 429) 

I . the proposed program? (p. 429) 

□ your qualifications and experience? (p. 429) 

Does the introduction indicate 
DD the problem or opportunity? (p. 429) 

DD the purpose of the proposal? (p. 429) 

DD the background of the problem or opportunity? 

(p. 429) 

□ your sources of information? (p. 429) 

. the scope of the proposal? (p. 429) 

DD the organization of the proposal? (p. 429) 

CD the key terms that you will use in the proposal? (p. 429) 


CD Does the description of the proposed program provide 
a clear, specific plan of action and justify the tasks you 
propose performing? (p. 430) 

Does the description of qualifications and experience clearly 

outline 

□ your relevant skills and past work? (p. 432) 

I the skills and background of the other participants? 

(p. 432) 

CD your department's (or organization's) relevant 
equipment, facilities, and experience? (p. 432) 

Is the budget 

□ complete? (p. 432) 

U correct? (p. 432) 

□ accompanied by an in-text reference? (p. 432) 

CD Do the appendixes include the relevant supporting 
materials, such as a task schedule, a description of 
evaluation techniques, and evidence of other successful 
projects? (p. 432) 


EXERCISES 


For more about memos, see Ch. 14, p. 372. 

1 . Study the National Science Foundation's (NSF) Grant 
Proposal Guide (http://www.nsf.gov/publications/pub 
_summ.jsp?ods_key=gpg). In what important ways does 
the NSF's guide differ from the advice provided in this 
chapter? What accounts for these differences? Present 
your findings in a 500-word memo to your instructor. 

2. TEAM EXERCISE Form groups according to major. 

Using the FedBizOpps website (https://www.fbo.gov), 
find and study an RFP for a project related to your 
academic field. What can you learn about the needs of 
the organization that issued the RFP? Flow effectively 
does it describe what the issuing organization expects 
to see in the proposal? Is it relatively general or specific? 
What sorts of evaluation techniques does it call for? In 
your response, include a list of questions that you would 
ask the issuing organization if you were considering 
responding to the RFP. Present your results in a memo 
to your instructor. 


3. Write a proposal for a research project that will 
constitute a major assignment in this course. Your 
instructor will tell you whether the proposal is to 
be written individually or collaboratively. Start by 
defining a technical subject that interests you. (This 
subject could be one that you are involved with at 
work or in another course.) Using abstract services and 
other bibliographic tools, compile a bibliography of 
articles and books on the subject. (See Chapter 6 for a 
discussion of finding information.) Create a reasonable 
real-world context. Flere are three common scenarios 
from the business world: 

• Our company uses Technology X to perform Task A. 
Should we instead be using Technology Y to perform 
Task A? For instance, our company uses traditional 
surveying tools in its contracting business. Should 
we be using GPS surveying tools instead? 
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• Our company has decided to purchase a tool to 
perform Task A. Which make and model of the tool 
should we purchase, and from which supplier should 
we buy it? For instance, our company has decided 

to purchase 10 multimedia computers. Which brand 
and model should we buy, and from whom should 
we buy them? Is leasing the tool a better option than 
purchasing? 

• Our company does not currently perform Function 
X. Is it feasible to perform Function X? For instance, 
we do not currently offer day care for our employees. 
Should we? What are the advantages and disadvan- 
tages of doing so? What forms can day care take? 
Flow is it paid for? 

Following are some additional ideas for topics: 

• the value of using social media to form ties with 
students in a technical-communication class on 
another campus 


• the need for expanded opportunities for internships 
or service-learning in your major 

• the need to create an advisory board of industry 
professionals to provide expertise about your major 

• the need to raise money to keep the college's 
computer labs up to date 

• the need to evaluate the course of study offered 
by your university in your major to ensure that it is 
responsive to students' needs 

• the advisability of starting a campus branch of a 
professional organization in your field 

• the need to improve parking facilities on campus 

• the need to create or improve organizations for 
minorities or women on campus 


CASE 16: Revising a Brief Proposal 



You work for an educational software company. Because most school districts are facing 
tough economic times, they need financial assistance in order to buy your company's 
products. The company has prepared a proposal guide for schools to use in applying 
for grants that will enable them to purchase the company's products. Your supervisor 
notes that this information hasn't been updated in a few years. Fie asks you to take a 
look at the effectiveness of the current sample proposal letter and suggest ways it could 
be improved. Fle'd also like you to annotate the letter to explain its various sections. 

To get started revising the letter, go to "Cases" under "Additional Resources" in Ch. 16: 
macmillanhighered.com/launchpad/techcomm1 1 e. 
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WRITING INFORMATIONAL REPORTS 


For more about analyzing an 
audience from another culture, see 
Ch. 5 , p. 95. 


COMPLEX, EXPENSIVE PROJECTS call for a lot of documents. Before a project 
begins, a vendor might write a proposal to interest prospective clients in its 
work. After a project is completed, an organization might write a completion 
report to document the project or a recommendation report to argue for a future 
course of action. In between, many people will write various informational 
reports. 

Whether they are presented as memos, emails, reports, or web pages, 
informational reports share one goal: to describe something that has 
happened or is happening now. Their main purpose is to provide clear, 
accurate, specific information to an audience. Sometimes, informational 
reports also analyze the situation. An analysis is an explanation of why 
something happened or how it happened. For instance, in an incident report 
about an accident on the job, the writer might speculate about how and why 
the accident occurred. 

This chapter discusses five kinds of informational reports: 

• A supervisor writes a directive explaining a company's new policy on recycling 
and describing informational sessions that the company will offer to help 
employees understand how to implement the policy. 

• An insurance adjuster writes a field report presenting the results of his 
inspection of a building after a storm caused extensive damage. 

• A research team writes a progress report explaining what the team has 
accomplished in the first half of the project, speculating on whether it will 
finish on time and within budget, and describing how it has responded to 
unexpected problems. 

• A worker at a manufacturing company writes an incident report after a toxic- 
chemical spill. 

• A recording secretary writes a set of meeting minutes that will become the 
official record of what occurred at a meeting of the management team of a 
government agency. 

Other types of informational reports are recommendation reports (see Chapter 1 8) 
and lab reports (see Chapter 1 9). 


Understanding the Process 
of Writing Informational Reports 

Writing informational reports involves the same writing process used in 
most other kinds of technical communication. The Focus on Process box on 
page 447 outlines this process. 

If your informational report will be addressed to people from other cul- 
tures, think about how your readers will react to your choice of application 
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FOCUS ON PROCESS 


In writing informational reports, pay special attention to these steps in the writing process. 


PLANNING 


In some cases, determining your audience and to whom to 
address the report is difficult. Choosing the appropriate format 
for your report can also be difficult. Consider whether your 
organization has a preferred format for reports and whether 
your report will be read by readers from other cultures who 
might expect a formal style and application. See Chapter 5 for 
more about analyzing your audience. 


DRAFTING 


Some informational reports are drafted on site. For instance, an 
engineer might use a tablet computer to "draft" a report as she 
walks around a site. For routine reports, you can sometimes use 
sections of previous reports or boilerplate. In a status report, for 
instance, you can copy the description of your current project 
from the previous report and then update it as necessary. See 
Chapter 2, page 26, for more about boilerplate. 



Informal does not mean careless. Revise, edit, and proofread. 
Even informal reports should be free of errors. 


and your writing style. If your readers expect a formal style, you will want 
to select a formal application (such as a report) rather than a memo. And 
consider adjusting your writing style, perhaps by adding parenthetical defini- 
tions and graphics or by using shorter sentences or more headings, to help 
readers whose first language is not English. 


Writing Directives 

In a directive, you explain a policy or a procedure you want your readers to 
follow. Even though you have the authority to require your readers to follow 
the policy, you want to explain why the policy is desirable or at least neces- 
sary. As discussed in Chapter 8, you are most persuasive when you present 
clear, compelling evidence (in the form of commonsense arguments, numeri- 
cal data, and examples); when you consider opposing arguments effectively; 
and when you present yourself as cooperative, moderate, fair-minded, and 
modest. If appropriate, include arguments that appeal to your readers’ 
broader goals of security, recognition, personal and professional growth, and 
connectedness. Figure 17.1 is an example of a directive. 


For more about understanding your 
audience's goals, see Ch. 8, p. 171. 
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The writer, the owner of a 
convenience store, begins with a 
clear explanation of the problem 
the directive addresses. Present- 
ing the reasons for the new policy 
shows respect for the readers and 
therefore makes the directive more 
persuasive. 


The writer uses a polite but official 
tone because the new policy is a 
policy, not a request. Notice that the 
directive specifies a penalty for not 
adhering to the policy and directs 
readers to their supervisors if they 
have questions. 


NOTICE TO EMPLOYEES 

Research has shown that minors find it easy to buy tobacco products even 
though state law prohibits sales to anyone under 18. To stop the sale of tobacco 
to minors and to comply with state law, we are implementing the following 
policy immediately: 

THIS COMPANY WILL NOT SELL CIGARETTES, CHEWING TOBACCO, 
SMOKELESS TOBACCO, OR SMOKING PARAPHERNALIA TO ANYONE 
UNDER THE AGE OF 18. 

YOU CAN BE FINED $100 PLUS COURT COSTS AND FEES FOR 
SELLING ANY OF THESE PRODUCTS TO ANYONE UNDER THE AGE 
OF 18. 

Under this new policy, you are required to request valid photo identification for 
anyone attempting to purchase tobacco products who appears to be under the 
age of 27. 

If a customer questions this policy, please explain that state law prohibits the sale 
of tobacco products to those under the age of 1 8, and therefore we refuse to sell 
to minors. 

A copy of the law is posted near the cash register. Please read the law carefully 
and, if you have questions, confer with your supervisor. 

Any employee who does not follow this policy will be subject to disciplinary 
action. Thank you for your cooperation. 


FIGURE 17.1 A Directive 


DOCUMENT ANALYSIS ACTIVITY 


To analyze a report presented as a website and a report presented through an interactive graphic, go to "Document Analysis 
Activities" under "Additional Resources" in Ch. 17: macmillanhighered.com/launchpad/techcommlle. 


High Plains Water-Level 
Monitoring Study 

Source: United States Geological 
Survey, 2014: http://ne.water.usgs 
.g ov/og w/h p wl m s/. 



"Global Forest Change" 
Interactive Map 

Hansen/UMD/Google/USGS/NASA. 
Hansen, M. C., P. V. Potapov, R. Moore, 
M. Hancher, S. A.Turubanova, A. 
Tyukavina, D. Thau, S. V. Stehman, S. J. 
Goetz, T. R. Loveland, A. Kommareddy, 
A. Egorov, L. Chini, C. O. Justice, and 
J. R. G. Townshend. 201 3. "High- 
Resolution Global Maps of 21 st- 
Century Forest Cover Change." Science 
342 (1 5 November): 850-53. Data 
available on-line from: http:// 
earthenginepartners.appspot.com 
/science-201 3-global-forest. 
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DOCUMENT ANALYSIS ACTIVITY 


Writing a Persuasive Directive 


To: Members, Budget Allocation Office 

From: Harold J. Jefferson, Director 

Subject: Travel Policy 

Date: January 23, 201 5 

It has come to my attention that certain members of this office are not 
abiding by the travel policies approved by the state. Let me offer a few 
examples. 

The Montana Revised Code includes this statement in its introduction: 

Persons who travel on State business are encouraged to incur the 
lowest practical and reasonable expense while still traveling in an 
efficient and timely manner. Those traveling on State business are 
expected to avoid impropriety, or the appearance of impropriety, 
in any travel expense. They must conduct State business with 
integrity, in compliance with applicable laws, and in a manner that 
excludes consideration of personal advantage. 

Yet I have learned from official sources that on four occasions in the last 
fiscal year, employees of this office have acted in flagrant violation of 
this policy. Two occasions involved choosing a flight that left at a more 
convenient time in the morning but that cost almost $160 more. One 
involved selecting a cab, rather than a shuttle bus, for a trip from the 
airport to downtown (a $24 difference), and one involved using room 
service when the motel has a cafe (a $14 difference). 

Another provision of the travel policy that has been violated on more than 
one occasion is the following: 

Travel expenses are not paid in advance except for airfare charged 
to the State air travel card, for online (Internet) air or train ticket 
purchases, and for conference registrations. 

Two employees have on more than three occasions each received 
reimbursements for air and/or train reservations made using their 
personal credit cards. As you know, using personal credit cards leaves the 
State without official documentation of the expense and gives the traveler 
bonus miles and/or cash back that properly belongs to the State. 

These are just two of the kinds of irregularities that have been brought 
to my attention. I do not need to tell you that these violations constitute 
serious breaches of public ethics. If they recur, they will be dealt with 
harshly. I sincerely hope that I do not have to address this issue again. 


This directive was sent to 
the members of a Montana 
government department. 

The questions below ask you 
to think about the process of 
writing persuasive directives (as 
discussed on p. 447). 

1. How would you describe 
the tone used by the writer? 
Provide an example to sup- 
port your claim. 

2 . The writer presents 
examples of what he calls 
violations of the state travel 
policy. Do these examples 
provide solid evidence that 
violations of the policy have 
in fact occurred? 

3 . How effectively has the 
writer encouraged his staff 
to abide by the travel policy? 
How might he improve the 
persuasiveness of the 
directive? 
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Writing Field Reports 

A common kind of informational report describes inspections, maintenance, 
and site studies. Such reports, often known as field reports, explain problems, 
methods, results, and conclusions, but they deemphasize methods and can 
include recommendations. The report in Figure 17.2 illustrates a possible 
variation on this standard report structure. 


FIGURE 17.2 

A Field Report 


Because the writer and the reader 
work for different companies, a let- 
ter is the appropriate format for this 
brief informational report. 


The word visual describes the 
methods. 


The writer states the purpose of the 
inspection. 


The writer has chosen to incorpo- 
rate the words summary and conclu- 
sion in the body of the letter rather 
than use headings as a method of 
organization. 


LOBATE CONSTRUCTION 

3311 Industrial Parkway 
Speonk, NY 13508 

Quality Construction Since 1957 


April 11,2015 

Ms. Christine Amalli, Head 
Civil Engineering 
New York Power 
Smithtown, NY 13507 

Dear Ms. Amalli: 

We are pleased to report the results of our visual inspection of the Chemopump 
after Run #9, a 30-day trial on Kentucky #10 coal. 

The inspection was designed to determine if the new Chemopump is compatible 
with Kentucky #10, the lowest-grade coal that you anticipate using. In preparation 
for the 30-day test run, the following three modifications were made by your 
technicians: 

• New front-bearing housing buffer plates of tungsten carbide were installed. 

• The pump-casting volute liner was coated with tungsten carbide. 

• New bearings were installed. 

Our summary is as follows. A number of small problems with the pump were 
observed, but nothing serious and nothing surprising. Normal break-in accounts 
for the wear. The pump accepted the Kentucky #10 well. 

The following four minor problems were observed: 

• The outer lip of the front-end bell was chipped along two-thirds of its 
circumference. 

• Opposite the pump discharge, the volute liner received a slight wear groove along 
one-third of its circumference. 

• The impeller was not free-rotating. 

• The holes in the front-end bell were filled with insulating mud. 

The following three components showed no wear: 

• 57 2 ” impeller 

• suction neck liner 

• discharge neck liner 

Our conclusion is that the problems can be attributed to normal break-in for a new 
Chemopump. The Kentucky #10 coal does not appear to have caused any 
extraordinary problems. In general, the new Chemopump seems to be operating well. 



( continued ) 
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page 2 

We would recommend, however, that the pump be modified as follows: 

1. Replace the front-end bell with a tungsten carbide-coated front-end bell. 

2. Replace the bearings on the impeller. 

3. Install insulation plugs in the holes in the front-end bell. 

Further, we recommend that the pump be reinspected after another 30-day run on 
Kentucky #10. 

If you have any questions or would like to authorize these modifications, please 
call me at 555-1241. As always, we appreciate the trust you have placed in us. 

Sincerely, 


Marvin Littridge 

Director of Testing and Evaluation 



Informational reports sometimes 
include recommendations. 


The writer concludes politely. 


FIGURE 17.2 A Field Report (continued) 
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GUIDELINES 


Responding to Readers' 
Questions in a Field Report 


When you write a field report, be sure to answer the following six questions: 

► What is the purpose of the report? 

► What are the main points covered in the report? 

► What were the problems leading to the decision to perform the procedure? 

► What methods were used? 

► What were the results? 

► What do the results mean? 

If appropriate, also discuss what you think should be done next. 


Writing Progress and Status Reports 

A progress report describes an ongoing project. A status report, sometimes 
called an actiuity report, describes the entire range of operations of a depart- 
ment or division. For example, the director of marketing for a manufacturing 
company might submit a monthly status report. 


For more about proposals, see Ch. 16. 
For more about completion reports 
and recommendation reports, see 


Ch. 18. 
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A progress report is an intermediate communication between a proposal 
(the argument that a project be undertaken) and a completion report (the 
comprehensive record of a completed project) or a recommendation report 
(an argument to take further action). Progress reports let you check in with 
your audience. 

Regardless of how well the project is proceeding, explain clearly and fully 
what has happened and how those activities or events will affect the overall 
project. Your tone should be objective, neither defensive nor casual. Unless 
your own ineptitude or negligence caused a problem, you’re not to blame. 
Regardless of the news you are delivering — good, bad, or mixed — your job is 
the same: to provide a clear and complete account of your activities and to 
forecast the next stage of the project. 

When things go wrong, you might be tempted to cover up problems and hope 
that you can solve them before the next progress report. This course of action 
is unwise and unethical. Chances are that problems will multiply, and you will 
have a harder time explaining why you didn’t alert your readers earlier. 


ETHICS NOTE 


REPORTING YOUR PROGRESS HONESTLY 

Withholding bad news is unethical because it can mislead readers. As sponsors or supervisors 
of the project, readers have a right to know how it is going. If you find yourself faced with any 
of the following three common problems, consider responding in these ways: 

• The deliverable — the document or product you will submit at the end of the project — 
won't be what you thought it would be. Without being defensive, describe the events that 
led to the situation and explain how the deliverable will differ from what you described in 
the proposal. 

• You won't meet your schedule. Explain why you are going to be late, and state when the 
project will be complete. 

• You won't meet the budget. Explain why you need more money, and state how much more 
you will need. 

ORGANIZING PROGRESS AND STATUS REPORTS 

The time pattern and the task pattern, two organizational patterns fre- 
quently used in progress and status reports, are illustrated in Figure 17.3. A 


In the time pattern, you describe 
all the work that you have com- 
pleted in the present reporting 
period and then sketch in the 
work that remains. Some writers 
include a section on present 
work, which enables them to 
focus on a long or complex task 
still in progress. 


THE TIME PATTERN 

THE TASK PATTERN 

Discussion 

Discussion 

A. Past Work 

A. Task 1 

B. Future Work 

1 . Past work 

2. Future work 
B. Task 2 

1 . Past work 

2. Future work 


The task pattern enables you 
to describe, in order, what has 
been accomplished on each task. 
Often a task-oriented structure 
incorporates the chronological 
structure. 


FIGURE 17.3 Organizational Patterns in Reports 






Sample Progress Report 
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status report is usually organized according to task; by its nature, this type of 
report covers a specified time period. 

CONCLUDING PROGRESS AND STATUS REPORTS 

In the conclusion of a progress or status report, evaluate how the project is 
proceeding. In the broadest sense, there are two possible messages: things 
are going well, or things are not going as well as anticipated. 

If appropriate, use appendixes for supporting materials, such as computa- 
tions, printouts, schematics, diagrams, tables, or a revised task schedule. Be 
sure to cross-reference these appendixes in the body of the report, so that 
readers can find them easily. 


Whether the news is positive or negative, these two suggestions will help you sound 
like a professional. 

► If the news is good, convey your optimism but avoid overstatement. 

overstated We are sure the device will do all that we ask of it, and more. 
realistic We expect that the device will perform well and that, in addition, it 


► Beware of promising early completion. Such optimistic forecasts rarely prove 
accurate, and it is embarrassing to have to report a failure to meet an optimistic 
deadline. 

► Don't panic if the preliminary results are not as promising as you had planned 
or if the project is behind schedule. Even the best-prepared proposal writers 
cannot anticipate all problems. As long as the original proposal was well planned 
and contained no wildly inaccurate computations, don't feel responsible. Just 
do your best to explain unanticipated problems and the status of the project. If 
your news is bad, at least give the reader as much time as possible to deal with it 
effectively. 


4 \ 



Projecting an Appropriate Tone in 
a Progress or Status Report 


might offer some unanticipated advantages. 


Sample Progress Report 


The following progress report was written for the project proposed on 
pages 436-42 in Chapter 16. (The recommendation report for this study 
is on page 488 in Chapter 18.) 
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In most professional settings, writ- 
ers use letterhead stationery for 
memos. 


Progress reports can be presented 
as memos or as reports. 


The writers include their titles and 
that of their primary reader. This 
way, future readers will be able 
to readily identify the reader and 
writers. 

The subject heading indicates the 
subject of the memo (the tablet 
study at Rawlings Regional Medical 
Center) and the purpose of the 
memo (progress report). 


Memos of more than one page 
should begin with a clear statement 
of purpose. Here, the writers com- 
municate the primary purpose of 
the document in one sentence. 


Memos of more than one page 
should contain a summary to serve 
as an advance organizer or to help 
readers who want only an overview 
of the document. 


Readers of progress reports want 
to know whether the project is 
proceeding according to schedule 
and (if applicable) on budget. 


Rawlings Regional Medical Center 
7500 Bannock Avenue 
Rawlings, MT 59211 


November 14, 2013 
Jill Bremerton, M.D. 

Chief Executive Officer 
Rawlings, Regional Medical Center 
Jeremy Elkins, Director of Information Technology 
Eloise Carruthers, Director of Nursing 
Rawlings Regional Medical Center 
Progress Report for the Tablet Study at RRMC 

Purpose 

This is a progress report on our study to recommend the best course of 
action for integrating tablet computers into the RRMC clinical setting. 

Summary 

On October 8, 2013, Dr. Jill Bremerton, RRMC Chief Executive Officer, 
approved our proposal to study national trends in tablet use, determine 
clinical-staff knowledge of and attitudes toward tablets, examine 
administrative models for tablet use, devise criteria for assessing tablets, 
and present our findings, including a recommendation. 

We have completed Tasks 1 and 2 (understanding tablet use in a clinical 
setting and determining the clinical staff's knowledge of and attitudes 
toward tablet use), as well as part of Task 3 (assessing the bring-your-own- 
device and hospital-owned tablet models). 

Our study is currently on schedule, and we expect to submit a 
recommendation report on December 14, 201 3, as indicated in our 
proposal dated October 6, 2013. 


Date: 

To: 


From: 


Subject: 
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Memo to Jill Bremerton, M.D. November 14, 201 3 Page 2 

Introduction 

On October 8, 201 3, Dr. Jill Bremerton, RRMC Chief Executive Officer, 
approved our proposal to determine the best course of action for 
integrating tablet computers into the RRMC clinical setting. 

Currently, RRMC has no formal policy on tablet usage by clinical staff. By 
default, we are following a bring-your-own-device (BYOD) approach. More 
than half of our clinical staff use their personal tablets in their work. This 
situation is not ideal because not all clinical staff are taking advantage of 
the enormous potential for improving patient care and reducing costs 
by using tablets, and IT is struggling to keep up with the work needed 
to ensure that all the different tablets are working properly and that 
information-security protocols required by HIPAA and the Affordable Care 
Act are not being violated. 

Dr. Bremerton approved our proposal to determine the best approach 
to take in making tablets available to all our clinical staff. Specifically, 

Dr. Bremerton asked us to perform five tasks: 

• Determine how tablets are being used by clinical staff across the nation. 

• Determine the RRMC clinical staff's knowledge of and attitudes toward 
tablet use. 

• Determine how hospitals administer the use of tablets in a clinical 
setting. 

• Establish criteria by which we might evaluate tablets for RRMC. 

• Assess available tablets based on our criteria. 

In the following sections, we present the results of our research to date, 
followed by an updated task schedule and references. 

Results of Research 

In this progress report, we present our completed work on Tasks 1-2 and 
our status on Task 3. Then we discuss our future work: Tasks 4-6. 

Task 1. Acquire a basic understanding of tablet use by clinical staff across • 
the nation 

Since the introduction of the Apple iPad in 201 0, the use of tablets by 
clinical staff in hospitals across the country has been growing steadily. 
Although there are no precise statistics on how many hospitals either 
distribute tablets to clinical staff or let them use their own devices in 


A brief statement of the context for 
the proposal. Note that the writers 
refer to the reader's having autho- 
rized the proposal. 


An explanation of the problem: 
the current situation is inadequate 
because the medical center is not 
taking full advantage of tablets 
and because IT is spending a lot of 
time ensuring that the tablets in 
use are in compliance with federal 
requirements. 


A formal statement of the task that 
Dr. Bremerton asked the writers to 
perform. 

Most of the information in the 
introduction is taken directly from 
the proposal. This reuse of text is 
ethical because the writers created 
it for that earlier document. 

The introduction concludes with an 
advance organizer for the rest of the 
proposal. 

The writers begin by describing the 
organization of the results section. 
Fora progress report, a chronologi- 
cal organization — completed work, 
then future work — makes good 
sense. 


The writers follow the task structure 
that they used in the proposal. 
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The writers skillfully integrate 
their secondary research into their 
discussion of the task. By doing so, 
they enhance their credibility. 


Memo to Jill Bremerton, M.D. November 1 4, 201 3 Page 3 

their work, the number of articles in trade magazines, exhibits at medical 
conferences, and discussions on discussion boards suggests that tablets 
are quickly becoming established in the clinical setting. And many 
hundreds of apps have already been written to enable users to carry out 
health-care-related tasks on tablets. 

The most extensive set of data on tablets in hospitals relates to the use of 
the iPad, the first tablet on the market. Ottawa Hospital has distributed 
more than 1 ,000 iPads to clinical staff; California Hospital is piloting a 
program with more than 1 00 iPads for hospital use; Kaiser Permanente 
is testing the iPad for hospital and clinical workflow; and Cedars-Sinai 
Medical Center is testing the iPad in its hospital. The University of 
Chicago's Internal Medicine Residency Program uses the iPad; the iPad is 
also being distributed to first-year medical students at Stanford, University 
of California-lrvine, and University of San Francisco. In addition, there are 
reports of Windows-based and Android-based tablets being distributed at 
numerous other hospitals and medical schools (Husain, 201 1). 

Today, tablets have five main clinical applications (Carr, 201 1): 

• Monitoring patients and collecting data. Clinical staff connect tablets to 
the hospital's monitoring instruments to collect patient information 
and transfer it to patients' health records without significant human 
intervention. In addition, staff access patient information on their 
tablets. 

• Ordering prescriptions, authorizations, and refills. Clinical staff use tablets 
to communicate instantly with the hospital pharmacy and off-site 
pharmacies, as well as with other departments within the hospital, such 
as the Imaging Department. 

• Scheduling appointments. Clinical staff use tablets to schedule doctor 
and nurse visits and laboratory tests, to send reminders, and to handle 
re-scheduling and cancellations. 

• Conducting research on the fly. Clinical staff use tablets to access 
medication databases and numerous reference works. 

• Educating patients. Clinical staff use videos and animations to educate 
patients on their conditions and treatment options. 

Tablets provide clinical staff with significant advantages. Staff do not need 
to go back to their offices to connect to the Internet or to the hospital's 
own medical-record system. Staff save time, reduce paper usage, and 
reduce transcription errors by not having to enter nearly as much data by 
hand. 



Sample Progress Report 


17 


457 


Memo to Jill Bremerton, M.D. November 14, 201 3 Page 4 

Task 2: Determine the RRMC clinical staff's knowledge of and attitudes 
toward tablet use 

On October 14, 2013, we sent all 147 clinical staff members an email 
linking to a four-question Qualtrix survey. In the email, we said that we 
were seeking opinions about tablet use by clinical-staff members who 
already own tablets and made clear that the survey would take less than 
two minutes to complete. (The questionnaire, including the responses, 
appears in the Appendix, page 9.) 

We received 96 responses, which represents 65 percent of the 147 staff 
members. We cannot be certain that all 96 respondents who indicated 
that they are tablet owners in fact own tablets. We also do not know 
whether all those staff members who own a tablet responded. However, 
given that some 75 percent of physicians in a 201 3 poll own tablets, we 
suspect that the 96 respondents accurately represent the proportion of 
our clinical staff who own tablets (Drinkwater, 2013). 

Here are the four main findings from the survey of tablet owners: 

• Some 47 percent of respondents own an Apple iPad, and 47 percent 
own either a Samsung Galaxy or another tablet that uses the Android 
operating system. Only 6 percent use the Microsoft Surface, one of the 
several Windows-based tablets. 

• Some 58 percent of the respondents strongly agree with the statement 
that they are expert users of their tablets. Overall, 90 percent agree more 
than they disagree with the statement. 

• Some 63 percent of respondents use their tablets for at least one clinical 
application. They have either loaded apps on their tablets themselves or 
had IT do so for them. 

• Some 27 percent of the respondents would prefer to continue to use 
their own tablets for clinical applications, whereas 38 percent would 
prefer to use a tablet supplied by RRMC. Some 35 percent had no strong 
feelings either way. None of the respondents indicated that they would 
prefer not to use a tablet at all for clinical applications. 

Task 3. Assess the BYOD and hospital-owned tablet models 
Currently, hospitals use one of two models for giving clinical staff 
access to tablets: the bring-your-own-device (BYOD) model and the 
purchase model, whereby the hospital purchases tablets to distribute 
to staff. In this section, we will present our findings on the relative 
advantages of each model. 
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The writers explain that they are in 
the process of completing Task 3. 


Memo to Jill Bremerton, M.D. 


November 14, 2013 


Page 5 


The BYOD model is based on the fact that, nationally, some three-quarters 
of physicians already own tablets (with the Apple iPad the single most 
popular model) (Drinkwater, 201 3). We could find no data on how many 
nurses own tablets. 

The main advantage of the BYOD model is that clinical staff already know 
and like their tablets; therefore, they are motivated to use them and 
less likely to need extensive training. In addition, the hardware costs are 
eliminated (or almost eliminated, since some hospitals choose to purchase 
some tablets for staff who do not have their own). Todd Richardson, CIO 
with Deaconess Health System, Evansville, Indiana (Jackson, 201 1), argues 
that staff members who own their own tablets use and maintain them 
carefully: they know how to charge, clean, store, and protect them. In 
addition, the hospital doesn't have to worry about the question of liability 
if staff members lose them during personal use. And if the staff member 
moves on to a new position at a different hospital, there is no dispute 
about who owns the information on the tablet. All the hospital has to do is 
disable the staff member's account. 

However, there are three main disadvantages to the BYOD model: 

• Some clinical staff do not have their own tablets, and some who do 
don't want to use them at work; to make the advantages of tablet 
use available to all the clinical staff, therefore, the hospital needs to 
decide whether to purchase tablets and distribute them to these staff 
members. 

• Labor costs are high because each tablet needs to be examined carefully 
by the hospital IT department to ensure that it contains no software that 
might interfere with or be incompatible with the health-care software 
that needs to be loaded onto it. This labor-intensive assessment by IT 
can seriously erode the cost savings from not having to buy the tablet 
itself. 

• Chances of loss increase because the staff member is more likely to use 
the tablet at home as well as in the hospital. 

Currently, we are studying the advantages and disadvantages of the other 
model for making tablets available to clinical staff: for the hospital to 
purchase the same tablet for each staff member. 

We are now completing Task 3 and beginning work on Task4. 
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Task 4: Establish criteria for evaluating tablets 
We will study the voluminous literature on tablets. We have already 
determined our first criterion: a cost of no more than $800 per device, fully 
configured with any commercial software needed to operate it. We will 
then determine the additional criteria to use in our study. 

Task 5. Assess available tablets based on our criteria 
We will study reviews in trade magazines and, if necessary, carry out on- 
site evaluations at RRMC. 

Task 6. Analyze our data and prepare a recommendation report 
We will draft our recommendation report and edit it in response to 
suggestions from interested readers among the clinical staff. Then, we 
will solicit one more round of edits and revise the report. Finally, we will 
present the report to you on December 14, 2013. 


Updated Schedule 

Figure 1 is an updated task schedule. The light blue bars represent tasks 
yet to be completed. 


Tasks 

Date of Tasks (by Weeks) 

Task 1 : Research tablet use 









Task 2: Determine staff 
knowledge and attitudes 











Task 3: Research 
management models 











Task 4: Establish criteria 











Task 5: Assess tablets based 
on criteria 











Task 6: Prepare report 
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Figure 1. Schedule of Project Tasks 


The Gantt chart shows the progress 
toward completing each of the 
project tasks. See the Tech Tip in 
Ch. 1 6, p. 434, for advice on how to 
create Gantt charts. 
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Conclusion 


Page 7 


The conclusion summarizes the 
status of the project. 


The writers end with a polite offer to 
provide additional information. 


We have successfully completed Tasks 1 -2 (and part of 3) and begun 
Tasks 4 and 5. We are on schedule to complete all tasks by the December 
1 4 deadline. We have a good understanding of how tablets are used 
nationwide, and we have completed our survey of tablet users among the 
RRMC clinical staff, as well as half of our study of the two administrative 
models used by hospitals. We are currently completing that task and 
are about to begin to establish criteria and analyze tablets based on 
them. In the report we will present on December 14, we will include our 
recommendation on how we think RRMC should proceed to take better 
advantage of the potential for clinical use of tablets. 

Please contact Jeremy Elkins, at jelkins@rrmc.org or at 444-3967, or Eloise 
Carruthers, at ecarruthers@rrmc.org or at 444-3982, if you have questions 
or comments or would like to discuss this project further. 


This list of references follows the 
APA documentation style, which 
is discussed in Appendix, Part B, 
p. 616. The APA documentation 
system calls for References to begin 
on a new page. Check with your 
instructor. 
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Appendix: Clinical-Staff Questionnaire 

This is the questionnaire we distributed to the 147 RRMC clinical staff 
members. We received 96 responses. The numbers in boldface below 
represent the percentage of respondents who chose each response. 


Questionnaire on Tablet Use at RRMC 

Directions: As you may know, Dr. Bremerton is conducting a study to determine 
whether to institute a formal policy on tablet use by clinical staff. 

If you own a tablet device, please respond to the following four questions. Your 
opinions can help us decide whether and how to develop a policy for tablet use at 
RRMC. We greatly appreciate your answering the following four questions. 

1 . Which brand of tablet do you own? 

47% Apple iPad 

28% Samsung Galaxy 
9% Amazon Kindle Fire 
6% Microsoft Surface 

1 0% Other (please name the brand) (Respondents named the Asus, Google 
Nexus, and a Toshiba model.) 

2. "I consider myself an expert user of my tablet." 

Strongly disagree 8% 2% 1 3% 19% 58% Strongly agree 

3. Do you currently use your tablet for a clinical application, such as monitoring 
patients or ordering procedures? 

63% Yes 
37% No 

4. If RRMC were to adopt a policy of using tablets for clinical applications (and to 
supply the appropriate software and training), which response best describes 
your attitude? 

27% I would prefer to use my own tablet. 

38% I would prefer to use a hospital-supplied tablet. 

35% I don't have strong feelings either way about using my own or a hospital- 
supplied tablet. 

0% I would prefer not to use any tablet at all for clinical applications. 

Thank you! 


Presenting the percentage data in 
boldface after each question is a 
clear way to communicate how the 
respondents replied. Although most 
readers will not be interested in the 
raw data, some will. 
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Writing Incident Reports 

An incident report describes an event such as a workplace accident, a health 
or safety emergency, or an equipment problem. (Specialized kinds of inci- 
dent reports go by other names, such as accident reports or trouble reports.) The 
purpose of an incident report is to explain what happened, why it happened, 
and what the organization did (or is going to do) to follow up on the incident. 
Incident reports often contain a variety of graphics, including tables, draw- 
ings, diagrams, and photographs, as well as videos. 

Incident reports can range from single-page forms that are filled out on 
paper or online to reports hundreds of pages long. Figure 17.4 shows an acci- 
dent form used at a university. 


FIGURE 17.4 An 
Accident Report Form 

Used by permission of University of 
North Carolina-Chapel Hill Environment, 
Health, and Safety. 


UNC^Gia£elJHill^Facilities^ervic^ 

APPENDIX A 

Employee’s Accident Report Form 
University of North Carolina at Chapel Hill 


This form is to be completed by the employee and forwarded to the Health and Safety 
office as soon as practicable after the injury. (See Human Resources Manual) 


Accident Date: 


1 . Name of employee: 


2. Date and time of injury: 


3. Descibe how the injury occurred: 


4. Describe what job duty you were doing at the time of your injury: 


5. Describe what part of your body was injured: 


6. Describe what you would recommend to prevent a reoccurrence: 


7. Further information you would like to include regarding your injury: 


Employee signature 


Date 


HTTP://www.fac.unc.edu 
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Figure 17.5 is the executive summary of a National Transportation Safety 
Board accident report on a 2012 head-on collision between two freight trains in 
Oklahoma. Investigators spent many months researching and writing the full 
report. 


On Sunday, June 24, 2012, at 10:02 a.m. central daylight time, eastbound 
Union Pacific Railroad (UP) freight train ZLAAH-22 and westbound UP 
freight train AAMMLX-22 collided head-on while operating on straight track 
on the UP Pratt subdivision near Goodwell, Oklahoma. Skies were clear, the 
temperature was 89°F, and visibility was 1 0 miles. 

The collision derailed 3 locomotives and 24 cars of the eastbound train 
and 2 locomotives and 8 cars of the westbound train. The engineer and 
the conductor of the eastbound train and the engineer of the westbound 
train were killed. The conductor of the westbound train jumped to safety. 
During the collision and derailment, several fuel tanks from the derailed 
locomotives ruptured, releasing diesel fuel that ignited and burned. 
Damage was estimated at $14.8 million. 

The National Transportation Safety Board determines that the probable 
cause of this accident was the eastbound Union Pacific Railroad train crew's 
lack of response to wayside signals because of the engineer's inability to see 
and correctly interpret the signals; the conductor's disengagement from 
his duties; and the lack of positive train control, which would have stopped 
the train and prevented the collision regardless of the crew's inaction. 
Contributing to the accident was a medical examination process that failed 
to decertify the engineer before his deteriorating vision adversely affected 
his ability to operate a train safely. 

The accident investigation focused on the following safety issues: 

• The actions and responsibilities of the train crews: Crew conversations 
in the locomotive cab concerning signal aspects, radio transmissions, or 
any condition that can affect the safe operation of the train are important 
crew activities. In this accident, as the train passed signals for advance 
approach, approach, and stop, the engineer actively adjusted the throttle 
and dynamic brake as if all three signals were clear. The fact that the 
conductor was disengaged from his duties and did not appropriately 
intervene as the train proceeded through the signals demonstrates . . . 

• The medical examination process for railroad engineer certification: 

The UP's medical records for the engineer of the eastbound train 
indicated that the engineer had passed his required vision test in 2009. 
However, the medical records from the engineer's personal physician, his 
ophthalmologist, and his optometrist documented . . . 

• The survivability of event recorder data:The lead and trailing locomotives 

of both trains in this accident had event recorders to capture and preserve 
operational data that is important to accident investigation. However, 
most of the data could not be retrieved after the severe damage to the 
lead locomotives from the postaccident fire 


FIGURE 17.5 Executive 
Summary of a Com- 
plex Accident Report 

Source: National Transportation Safety 
Board, 2013: http://www.ntsb.gov/doclib 
/reports/201 3/RAR1 302.pdf. 


The summary — two pages near the 
beginning of a 65-page report — 
begins with the basic facts about 
the accident. 


The writers discuss the probable 
cause of the accident and the result- 
ing damage to the trains. 


The writers explain the issues raised 
by this fatal accident. 


( continued ) 
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Finally, the writers list the results of 
the investigation. 


For more about conducting 
meetings, see Ch. 4, p. 61. 


• The need for implementation of positive train control: Before reaching 
the Goodwell siding, the eastbound train crew had passed three signals 
without appropriately responding by slowing and then stopping their 
train. Regardless of the reason for the crew's nonresponse, had a positive 
train control system been in place in the area of the accident, it would have 
slowed and stopped the train, avoiding the collision. 

As a result of this investigation, the National Transportation Safety Board makes 
safety recommendations to the Federal Railroad Administration, the Brotherhood 

of Locomotive Engineers andTrainmen, The National Transportation 

Safety Board also reiterates recommendations to the Federal Railroad 
Administration and the Association of American Railroads and reclassifies three 
recommendations to the Federal Railroad Administration. 


Writing Meeting Minutes 

Minutes, an organization’s official record of a meeting, are distributed to all 
those who belong to the committee or group represented at the meeting. 
Sometimes, minutes are written by administrative assistants; other times 
they are written by technical professionals or technical communicators. 

In writing minutes, be clear, comprehensive, objective, and diplomatic. Do not 
interpret what happened; simply report it. Because meetings rarely follow the 
agenda perfectly, you might find it challenging to provide an accurate record of 
the meeting. If necessary, interrupt the discussion to request a clarification. 

Do not record emotional exchanges between participants. Because min- 
utes are the official record of the meeting, you want them to reflect positively 
on the participants and the organization. For example, in a meeting a person 
might say, undiplomatically, that another person’s idea is stupid, a comment 
that might lead to an argument. Don’t record the argument. Instead, describe 
the outcome: “After a discussion of the merits of the two approaches, the 
chair asked the Facilities Committee to consider the approaches and report 
back to membership at the next meeting.” 

Figure 17.6, an example of an effective set of minutes, was written using 
a Microsoft template. Many organizations today use templates like this one, 
which has three advantages: 

• Because it is a word-processing template, the note taker can enter 
information on his or her computer or tablet during the meeting, reducing 
the time it takes to publish the minutes. 

• Because the template is a form, it prompts the note taker to fill in the 
appropriate information, thus reducing the chances that he or she will 
overlook something important. 

• Because the template is a table, readers quickly become accustomed to 
reading it and thereby learn where to look for the information they seek. 
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Weekly Planning Committee Meeting 

MINUTES February 14, 2015 3:40 p.m. conference room 


meeting called by 

Principal Robert Barson 

type of meeting 

regular weekly 

note taker 

Zenda Hill 

attendees 

William Sipe, Patty Leahy, George Zaerr, Herbert 
Simon, Robert Barson, Zenda Hill. Absent: Heather 
Evett 


Agenda topics 

2 minutes approval of minutes ZendaHill 


discussion 

The minutes of the February 7, 2015, meeting were read. 

action items 

person responsible 

deadline 

One correction was made: In paragraph 2, 
"800 hours" was replaced with "80 hours." 
The minutes were then unanimously 
approved. 

Zenda Hill 

N/A 


authorization for antidrug 

30 minutes presentation by Alan Winston Principal Barson 


discussion 

Principal Barson reported on his discussion with Peggy Giles 
of the School District, who offered positive comments about 
Winston's presentations at other schools in the district last year. 

Mr. Zaerr expressed concern about the effect of the visit on 
the teaching schedule. Principal Barson acknowledged that 
the visit would disrupt one whole day but said that the chairs 
unanimously approved of the visit. Student participation 
would be voluntary, and the chairs offered to give review 
sessions to those students who elected not to attend. 

Ms. Hill asked if there was any new business. There was none. 

action items 

person responsible 

deadline 

Ms. Hill called for a vote on the motion. 
The motion carried 5-0, with one 
abstention. 

Ms. Hill will arrange 
the Winston visit. 

February 
23, 2015 

There being no new business, Ms. Hill 
moved that the committee adjourn. Motion 
passed. The committee adjourned at 4:05 
p.m. 

N/A 

N/A 


The first section of this template 
calls for information about the 
logistics of the meeting. You can 
modify the template to make it 
appropriate for your organization. 


The second section of this template 
is devoted to the agenda items for 
the meeting. 


Note that for each agenda item, 
the note taker is prompted to state 
how long the discussion took, the 
subject of the discussion, and the 
name of the person leading the 
discussion. 


For each agenda item, the note 
taker records the main points of the 
discussion and the action items. 
Because the template calls for the 
action item (such as a vote or a 
task to be done), the name of the 
person responsible for doing the 
task, and the deadline for the task, 
there should be no confusion about 
who is to do which task and when 
it is due. 


FIGURE 17.6 A Set of Meeting Minutes 
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WRITER'S CHECKLIST 


EH Did you choose an appropriate application for the 
informational report? (p. 446) 

Does the directive 

EH clearly and politely explain your message? (p. 447) 

□ explain your reasoning, if appropriate? (p. 447) 

Does the field report 

EH clearly explain the important information? (p. 450) 

□ use, if appropriate, a problem-methods-results- 
conclusion-recommendations organization? (p. 450) 

Does the progress or status report 

EH clearly announce that it is a progress or status report? 
(p. 451) 

□ use an appropriate organization? (p. 452) 

EH clearly and honestly report on the subject and forecast 
the problems and possibilities of the future work? 

(p. 452) 


EH include, if appropriate, an appendix containing 

supporting materials that substantiate the discussion? 
(p. 453) 

Does the incident report 

I ! explain what happened? (p. 462) 

EH explain why it happened? (p. 462) 

EH explain what the organization did about it or will do 
about it? (p. 462) 

Do the minutes 

LH provide the necessary housekeeping details about the 
meeting? (p. 464) 

EH explain the events of the meeting accurately? (p. 464) 

I reflect positively on the participants and the 
organization? (p. 464) 


EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . As the manager of Lewis, Lewis, and Wollensky Law, LPC, 
you have been informed by some clients that tattoos 
on the arms and necks of your employees are creating 

a negative impression. Write a directive in the form of a 
memo defining a new policy: employees are required to 
wear clothing that covers any tattoos on their arms and 
necks. 

2. Write a progress report about the research project you 
are working on in response to Exercise 3 on page 443 
in Chapter 16. If the proposal was a collaborative effort, 
collaborate with the same group members on the 
progress report. 

3. TEAM EXERCISE You are one of three members of 
the administrative council of your college's student 


association. Recently, the three of you have concluded 
that your weekly meetings, which are open to all 
students, have become chaotic. There are two main 
reasons for this: you do not use parliamentary 
procedure (rules for conducting meetings so that they 
are efficient and fair), and controversial issues have 
arisen that have attracted an increasing number of 
students. You have decided that it is time to consider 
adopting parliamentary procedures. Look on the web 
for models of parliamentary procedure. Is there one that 
you can adopt? Could you combine elements of several 
models to create an effective process? Find or write a 
brief set of procedures, being sure to cite your sources. 
In a memo to your instructor, discuss the advantages 
and disadvantages of the model you propose, and 
submit it along with the procedures. 
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CASE 1 7: Writing a Directive About Using Agendas for Meetings 


Your supervisor is concerned that weekly meetings among the engineering staff at your 
company take too long — and therefore cost the company too much money. Because one 
of your tasks is to take minutes for these meetings, you know all too well that they are often 
inefficient. Your supervisor asks you to look into creating or adapting an agenda to impose 
structure and shorten the meetings and to write a directive explaining why agendas 
will now be used for these meetings. To get to work improving your company's meeting 
policy, go to "Cases" under "Additional Resources" in Ch. 1 7: macmillanhighered.com 
/launchpad/techcomml 1 e. 




Writing 

Recommendation 

Reports 

Understanding the Role of Recommendation Reports 469 

Using a Problem-Solving Model for Preparing 
Recommendation Reports 470 

IDENTIFY THE PROBLEM OR OPPORTUNITY 477 

ESTABLISH CRITERIA FOR RESPONDING TO THE PROBLEM OR OPPORTUNITY 471 
DETERMINETHE OPTIONS 472 

STUDY EACH OPTION ACCORDING TO THE CRITERIA 473 
DRAW CONCLUSIONS ABOUT EACH OPTION 474 

FORMULATE RECOMMENDATIONS BASED ON THE CONCLUSIONS 474 

■ ETHICS NOTE: Presenting Honest Recommendations 475 

Writing Recommendation Reports 475 

WRITING THE BODY OF THE REPORT 476 

■ GUIDELINES: Writing Recommendations 478 
WRITING THE FRONT MATTER 479 

■ TECH TIP: HowTo Format Headers, Footers, and Page Numbers 482 
m TECH TIP: HowTo Create a Table of Contents 482 

■ GUIDELINES: Writing an Executive Summary 484 
WRITING THE BACK MATTER 484 

■ DOCUMENT ANALYSIS ACTIVITY: Analyzing an Executive Summary 485 

■ DOCUMENT ANALYSIS ACTIVITY: Influenza 201 0-201 1 : ACIP Vaccination 
Recommendations 486 and El 

Sample Recommendation Report 487 


WRITER'S CHECKLIST 512 


EXERCISES 513 

CASE 18: Analyzing Decision Matrices 514 and 


CHAPTER 1 7 DISCUSSED informational reports: those in which the writer's 
main purpose is to present information. This chapter discusses recommendation 
reports. A recommendation report also presents information but goes one step 
further by offering suggestions about what the readers ought to do next. 

Here are examples of the kinds of questions a recommendation report might 
address: 

• What should we do about Problem X? What should we do about the 
increased cost of copper, which we use in manufacturing our line of electronic 
components? 

• Should we do Function X? Although we cannot afford to pay tuition for all 
college courses our employees wish to take, can we reimburse them for classes 
directly related to their work? 

• Should we use Technology A or Technology B to do Function X? Should 
we continue to supply our employees with laptops, or should we switch to 
tablets? 

• We currently use Method A to do Function X. Should we be using Method B? 

We sort our bar-coded mail by hand; should we buy an automatic sorter? 

Each of these questions can lead to a wide variety of recommendations, ranging 
from "do nothing" to "study this some more" to "take the following actions 
immediately." 


Understanding the Role 
of Recommendation Reports 

A recommendation report can be the final link in a chain of documents that 
begins with a proposal and continues with one or more progress reports. This 
last, formal report is often called a final report, a project report, a recommenda- 
tion report, a completion report, or simply a report. The sample report beginning 
on page 488 is the recommendation report in the series about tablet comput- 
ers at Rawlings Regional Medical Center presented in Chapters 16 and 17. 

A recommendation report can also be a freestanding document, one that 
was not preceded by a proposal or by progress reports. For instance, you 
might be asked for a recommendation on whether your company should 
offer employees comp time (compensating those who work overtime with 
time off) instead of overtime pay. This task would call for you to research the 
subject and write a single recommendation report. 

Most recommendation reports discuss questions of feasibility. Feasibility 
is a measure of the practicality of a course of action. For instance, a company 


For more about proposals and 
progress reports, see Ch. 16 and 
Ch. 17, p. 451. 
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might conduct a feasibility study of whether it should acquire a competing 
company. In this case, the two courses of action are to acquire the competing 
company or not to acquire it. Or a company might do a study to determine 
which make and model of truck to buy for its fleet. 

A feasibility report is a report that answers three kinds of questions: 

• Questions of possibility. We would like to build a new rail line to link 
our warehouse and our retail outlet, but if we cannot raise the money, 
the project is not possible. Even if we can find the money, do we have 
government authorization? If we do, are the soil conditions appropriate for 
the rail link? 

• Questions of economic wisdom. Even if we can afford to build the rail link, 
should we do so? If we use all our resources on this project, what other 
projects will have to be postponed or canceled? Is there a less expensive or 
a less financially risky way to achieve the same goals? 

• Questions of perception. Because our company’s workers have recently 
accepted a temporary wage freeze, they might view the rail link as an 
inappropriate use of funds. The truckers’ union might see it as a threat 
to truckers’ job security. Some members of the public might also be 
interested parties, because any large-scale construction might affect the 
environment. 


For more about the writing process, 
see Ch. 3 and Ch. 13, p. 345. For more 
about collaboration, see Ch. 4. 


Using a Problem-Solving Model 

for Preparing Recommendation Reports 

The writing process for a recommendation report is similar to that for any 
other technical communication: 

• Planning. Analyze your audience, determine your purpose, and visualize 
the deliverable: the report you will submit. Conduct appropriate secondary 
and primary research. 

• Drafting. Write a draft of the report. Large projects often call for 
many writers and therefore benefit from shared document spaces and 
wikis. 

• Revising. Think again about your audience and purpose, and then make 
appropriate changes to your draft. 

• Editing. Improve the writing in the report, starting with the largest 
issues of development and emphasis and working down to the sections, 
paragraphs, sentences, and individual words. 

• Proofreading. Go through the draft slowly, making sure you have written 
what you wanted to write. Get help from others. 

In addition to this model of the writing process, you need a problem- 
solving model for conducting the analysis that will enable you to write the 
recommendation report. The following discussion explains in more detail the 
problem-solving model shown in Figure 18.1. 
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FIGURE 18.1 

A Problem-Solving 
Model for Recom- 
mendation Reports 

As you work through this process, 
you might find that you need to go 
back to a previous step — or even to 
the first step — as you think more 
about your subject, audience, and 
purpose. 


Determine the Options 

List the possible courses of action, from doing nothing to taking immediate action. 

Study Each Option According to the Criteria 

Analyze each option by studying the data on how well it satisfies each criterion. 

I 

Draw Conclusions About Each Option 

For each option, determine whether (or how well) it satisfies each criterion. 

Formulate Recommendations Based on the Conclusions 

Present your suggestions about how to proceed. 


Identify the Problem or Opportunity 

What is not working as well as it might, or what situation can we exploit? 

Establish Criteria for Responding to the Problem or Opportunity 

For example, any solution to our problem must reduce the number of manufacturing 
defects by 50 percent and cannot cost more than $75,000. 


IDENTIFY THE PROBLEM OR OPPORTUNITY 

What is not working or is not working as well as it might? What situation 
presents an opportunity to decrease costs or improve the quality of a 
product or service? Without a clear statement of your problem or oppor- 
tunity, you cannot plan your research. 

For example, your company has found that employees who smoke are 
absent and ill more often than those who don’t smoke. Your supervisor has 
asked you to investigate whether the company should offer a free smoking- 
cessation program. The company can offer the program only if the com- 
pany’s insurance carrier will pay for it. The first thing you need to do is talk 
with the insurance agent; if the insurance carrier will pay for the program, 
you can proceed with your investigation. If the agent says no, you have 
to determine whether another insurance carrier offers better coverage or 
whether there is some other way to encourage employees to stop smoking. 

ESTABLISH CRITERIA FOR RESPONDING TO 
THE PROBLEM OR OPPORTUNITY 

Criteria are standards against which you measure your options. Criteria For more about establishing criteria, 

can be classified into two categories: necessary and desirable. For example, seeCh. 7,p. 156. 
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if you want to buy a photocopier for your business, necessary criteria might 
be that each copy cost less than two cents to produce and that the photo- 
copier be able to handle oversized documents. If the photocopier doesn’t 
fulfill those two criteria, you will not consider it further. By contrast, desirable 
criteria might include that the photocopier be capable of double-sided copy- 
ing and stapling. Desirable criteria let you make distinctions among a variety 
of similar objects, objectives, actions, or effects. If a photocopier does not 
fulfill a desirable criterion, you will still consider it, although it will be less 
attractive. 

Until you establish your criteria, you don’t know what your options 
are. Sometimes you are given your criteria: your supervisor tells you how 
much money you can spend, for instance, and that figure becomes one of 
your necessary criteria. Other times, you derive your criteria from your 
research. 

DETERMINE THE OPTIONS 

After you establish your criteria, you determine your options. Options are 
potential courses of action you can take in responding to a problem or oppor- 
tunity. Determining your options might be simple or complicated. 

Sometimes your options are presented to you. For instance, your supervi- 
sor asks you to study two vendors for accounting services and recommend 
one of them. The options are Vendor A or Vendor B. That’s simple. 

In other cases, you have to consider a series of options. For example, your 
department’s photocopier is old and breaking down. Your first decision is 
whether to repair it or replace it. Once you have answered that question, 
you might have to make more decisions. If you are going to replace it, what 
features should you look for in a new one? Each time you make a decision, 


Should we repair 
or replace our 
photocopier? 


Repairing it would 
not meet our 
long-term 
needs. 


Replacing it would 
be the better 
decision in the 
long term. 
Should we look 
at color copiers? 


Color would be 
useful, but we 
can't justify the 
costs because 
we do not use 
color often. 


Black and white 
would be a much 
better value and 
meet almost all 
our other needs. 



Each branch in the logic boxes calls for you to 
make a decision. 


FIGURE 18.2 Using Logic Boxes To Plot a Series of Options 
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you have to answer more questions until, eventually, you arrive at a recom- 
mendation. For a complicated scenario like this, you might find it helpful to 
use logic boxes or flowcharts to sketch the logic of your options, as shown in 
Figure 18.2. 

As you research your topic, your understanding of your options will likely 
change. At this point, however, it is useful to understand the basic logic of 
your options or series of options. 

STUDY EACH OPTION ACCORDING TO THE CRITERIA 

Once you have identified your options (or series of options), study each one 
according to the criteria. For the photocopier project, secondary research 
would include studying articles about photocopiers in technical journals 
and specification sheets from the different manufacturers. Primary research 
might include observing product demonstrations as well as interviewing 
representatives from different manufacturers and managers who have pur- 
chased different brands. 

To make the analysis of the options as objective as possible, profession- 
als sometimes create a decision matrix, a tool for systematically evaluating 
each option according to each criterion. A decision matrix is a table (or 
a spreadsheet), as shown in Figure 18.3. Here the writer is nearly at the 
end of his series of options: he is evaluating three similar photocopiers 
according to three criteria. Each criterion has its own weight, which sug- 
gests how important it is. The greater the weight, the more important the 
criterion. 

As shown in Figure 18.3, the criterion of pages per minute is relatively 
unimportant: it receives a weight of 1. For this reason, the Ricoh copier, even 
though it receives a high rating for pages per minute (9), receives only a mod- 
est score of 9 (1 x 9 = 9) on this criterion. However, the criterion of color copy- 
ing is quite important, with a weight of 4. On this criterion, the Ricoh, with its 
rating of 10, achieves a very high score (4 x 10 = 40). 


Criteria and Weight 

Options 

Ricoh 

Xerox 

Sharp 

Criterion 

Weight 

Rating 

Score 111 

Rating 

Score 111 

Rating 

Score 111 

Pages/min. 

1 

9 

9 

6 

6 

3 

3 

Duplex 

3 

1 

3 

3 

9 

10 

30 

Color 

4 

10 

40 

1 

4 

10 

40 

Total Score 



52 


19 


73 


(1) Score = weight x rating. 

FIGURE 18. 3 A Decision Matrix 

Spreadsheet programs often contain templates for creating decision matrices. 


For more about research techniques, 
see Ch. 6. 
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But a decision matrix cannot stand on its own. You need to explain your 
methods. That is, in the discussion or in footnotes to the matrix, you need to 
explain the following three decisions: 

• Why you chose each criterion — or didn't choose a criterion the reader might 
have expected to see included. For instance, why did you choose duplexing 
(double-sided printing) but not image scanning? 

• Why you assigned a particular weight to each criterion. For example, why is 
the copier’s ability to make color copies four times more important than 
its speed? 

• Why you assigned a particular rating to each option. For example, why 
does one copier receive a rating of only 1 on duplexing, whereas another 
receives a 3 and a third receives a 10? 

A decision matrix is helpful only if your readers understand your methods 
and agree with the logic you used in choosing the criteria and assigning the 
weight and ratings for each option. 

Although a decision matrix has its limitations, it is useful for both you and 
your readers. For you as the writer, the main advantage is that it helps you do 
a methodical analysis. For your readers, it makes your analysis easier to fol- 
low because it clearly presents your methods and results. 

DRAW CONCLUSIONS ABOUT EACH OPTION 

Whether you use a decision matrix or a less-formal means of recording your 
evaluations, the next step is to draw conclusions about the options you studied — 
by interpreting your results and writing evaluative statements about the options. 

For the study of photocopiers, your conclusion might be that the Sharp model 
is the best copier: it meets all your necessary criteria and the greatest number of 
desirable criteria, or it scores highest on your matrix. Depending on your read- 
ers’ preferences, you can present your conclusions in any one of three ways. 

• Rank all the options: the Sharp copier is the best option, the Ricoh copier is 
second best, and so forth. 

• Classify all the options in one of two categories: acceptable and 
unacceptable. 

• Present a compound conclusion: the Sharp offers the most technical 
capabilities; the Ricoh is the best value. 

FORMULATE RECOMMENDATIONS BASED ON 
THE CONCLUSIONS 

If you conclude that Option A is better than Option B — and you see no obvi- 
ous problems with Option A — recommend Option A. But if the problem has 
changed or your company’s priorities or resources have changed, you might 
decide to recommend a course of action that is inconsistent with the conclu- 
sions you derived. Your responsibility is to use your judgment and recom- 
mend the best course of action. 
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ETHICS NOTE 


PRESENTING HONEST RECOMMENDATIONS 

As you formulate your recommendations, you might know what your readers want you to 
say. For example, they might want you to recommend the cheapest option, or one that uses a 
certain kind of technology, or one that is supplied by a certain vendor. Naturally, you want to 
be able to recommend what they want, but sometimes the facts won't let you. Your responsi- 
bility is to tell the truth — to do the research honestly and competently and then present the 
findings honestly. Your name goes on the report. You want to be able to defend your recom- 
mendations based on the evidence and your reasoning. 

One worrisome situation that arises frequently is that none of the options would be a com- 
plete success or none would work at all. What should you do? You should tell the truth about 
the options, warts and all. Give the best advice you can, even if that advice is to do nothing. 


Writing Recommendation Reports 

The following discussion presents a basic structure for a recommendation 
report. Remember that every document you write should reflect its audience, 
purpose, and subject. Therefore, you might need to modify, add to, or delete 
some of the elements discussed here. 

Reports that are lengthy and complex are often written collaboratively. 

As you begin the project that will culminate in the report, consider whether 
it would make sense to set up a shared writing space, a wiki, or some other 
method for you and your team members to write and edit the report 
collaboratively. 

The easiest way to draft a report is to think of it as consisting of three sec- 
tions: the front matter, the body, and the back matter. Table 18.1 on page 476 
shows the purposes of and typical elements in these three sections. 

You will probably draft the body before the front and the back matter. This 
sequence is easiest because you think through what you want to say in the 
body and then draft the front and back matter based on it. 

If you are writing your recommendation report for readers from other 
cultures, keep in mind that conventions differ from one culture to another. In 
the United States, reports are commonly organized from general to specific. 
That is, the most general information (the abstract and the executive sum- 
mary) appears early in the report. In many cultures, however, reports are 
organized from specific to general. Detailed discussions of methods and 
results precede discussions of the important findings. 

Similarly, elements of the front and back matter are rooted in culture. For 
instance, in some cultures — or in some organizations — writers do not cre- 
ate executive summaries, or their executive summaries differ in length or 
organization from those discussed here. According to interface designer Pia 
Honold (1999), German users of high-tech products rely on the table of con- 
tents in a manual because they like to understand the scope and organiza- 
tion of the manual. Therefore, writers of manuals for German readers should 
include comprehensive, detailed tables of contents. 


For more on collaboration, see Ch. 4. 
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TABLE 18.1 ELEMENTS OF A TYPICAL REPORT 





SECTION OFTHE 


TYPICAL ELEMENTS IN THE 

REPORT 

PURPOSES OFTHE SECTION 

SECTION 

Front matter 

• to orient the reader to the 
subject 

• to provide summaries for 
technical and managerial 
readers 

• to help readers navigate the 
report 

• to help readers decide whether 
to read the document 

• letter of transmittal (p. 479) 

• cover (p. 479) 

• title page (p. 479) 

• abstract (p.479) 

• table of contents (p. 480) 

• list of illustrations (p. 481) 

• executive summary (p. 483) 

Body 

• to provide the most 
comprehensive account of the 
project, from the problem or 
opportunity that motivated it 
to the methods and the most 
important findings 

• introduction (p. 476) 

• methods (p. 477) 

• results (p. 477) 

• conclusions (p. 478) 

• recommendations (p. 478) 

Back matter 

• to present supplementary 
information, such as more- 
detailed explanations than are 
provided in the body 

• to enable readers to consult the 
secondary sources the writers 
used 

• glossary (p. 484) 

• list of symbols (p. 484) 

• references (p. 486) 

• appendixes (p. 487) 


Study samples of writing produced by people from the culture you are 
addressing to see how they organize their reports and use front and back 
matter. 

WRITING THE BODY OF THE REPORT 

The elements that make up the body of a report are discussed here in the 
order in which they usually appear in a report. However, you should draft the 
elements in whatever order you prefer. The sample recommendation report 
on pages 488-511 includes these elements. 

Introduction The introduction helps readers understand the technical dis- 
cussion that follows. Start by analyzing who your readers are. Then consider 
these questions: 

• What is the subject of the report? If the report follows a proposal and a 
progress report, you can probably copy this information from one of those 
documents, modifying it as necessary. Reusing this information is efficient 
and ethical. 
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• What is the purpose of the report? The purpose of the report is not 
the purpose of the project. The purpose of the report is to explain a 
project from beginning (identifying a problem or an opportunity) to end 
(presenting recommendations). 

• What is the background of the report? Include this information, even if you 
have presented it before; some of your readers might not have read your 
previous documents or might have forgotten them. 

• What are your sources of information? Briefly describe your primary and 
secondary research, to prepare your readers for a more detailed discussion 
of your sources in subsequent sections of the report. 

• What is the scope of the report? Indicate the topics you are including, as 
well as those you are not. 

• What are the most significant findings? Summarize the most significant 
findings of the project. 

• What are your recommendations? In a short report containing a few simple 
recommendations, include those recommendations in the introduction. 

In a lengthy report containing many complex recommendations, briefly 
summarize them in the introduction, then refer readers to the more 
detailed discussion in the recommendations section. 

• What is the organization of the report? Indicate your organizational pattern 
so that readers can understand where you are going and why. 

• What key terms are you using in the report? The introduction is an 
appropriate place to define new terms. If you need to define many terms, 
place the definitions in a glossary and refer readers to it in the introduction. 

Methods The methods section answers the question “What did you do?” In 
drafting the methods section, consider your readers’ knowledge of the field, 
their perception of you, and the uniqueness of the project, as well as their 
reasons for reading the report and their attitudes toward the project. Provide 
enough information to enable readers to understand what you did and why 
you did it that way. If others will be using the report to duplicate your meth- 
ods, include sufficient detail. 

Results Whereas the methods section answers the question “What did you 
do?” the results section answers the question “What did you see or determine?” 
Results are the data you discovered or compiled. Present the results 
objectively, without comment. Save the interpretation of the results — your 
conclusions — for later. If you combine results and conclusions, your read- 
ers might be unable to follow your reasoning and might not be able to tell 
whether the evidence justifies your conclusions. 

Your audience’s needs will help you decide how to structure the results. 
How much they know about the subject, what they plan to do with the 
report, what they expect your recommendation(s) to be — these and many 


For more about purpose statements, 
seeCh. 5, p. 109. 
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For more about evaluating evidence 
and drawing conclusions, see Ch. 6, 
pp. 127-30. 


other factors will affect how you present the results. For instance, sup- 
pose that your company is considering installing a VoIP phone system that 
will enable employees to make telephone calls over the Internet, and you 
conducted the research on the available systems. In the introduction, you 
explain the disadvantages of the company’s current phone system. In the 
methods section, you describe how you established the criteria you applied 
to the available phone systems, as well as your research procedures. In the 
results section, you provide the details of each phone system you are consid- 
ering, as well as the results of your evaluation of each system. 

Conclusions Conclusions answer the question “What does it mean?” They 
are the implications of the results. To draw conclusions, you need to think 
carefully about your results, weighing whether they point clearly to a single 
meaning. 

Recommendations Recommendations answer the question “What 
should we do?” As discussed earlier in this chapter, recommendations do not 
always flow directly from conclusions. Always consider recommending that 
the organization take no action or no action at this time. 



4 \ 


GUIDELINES 


Writing Recommendations 


As you draft your recommendations, consider the following four factors: 


► Content. Be clear and specific. If the project has been unsuccessful, don't simply 
recommend that your readers "try some other alternatives."What alternatives do 
you recommend and why? 

► Tone. When you recommend a new course of action, be careful not to offend 
whoever formulated the earlier course. Do not write that following your recom- 
mendations will "correct the mistakes"that have been made. Instead, your recom- 
mendations should "offer great promise for success." A restrained, understated 
tone is more persuasive because it shows that you are interested only in the 
good of your company, not personal rivalries. 

► Form. If the report leads to only one recommendation, use traditional para- 
graphs. If the report leads to more than one recommendation, consider a num- 
bered list. 


► Location. Consider including a summary of the recommendations — or, if they are 
brief, the full list — after the executive summary or in the introduction as well as at 
the end of the body of the report. 
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WRITING THE FRONT MATTER 

Front matter is common in reports, proposals, and manuals. As indicated 
in Table 18.1 on page 476, front matter helps readers understand the whole 
report and find the information they seek. Most organizations have estab- 
lished formats for front matter. Study the style guide used in your company 
or, if there isn’t one, examples from the files to see how other writers have 
assembled their reports. 

Letter of Transmittal In the letter of transmittal, which can take the 
form of a letter or a memo, the writer introduces the primary reader to the 
purpose and content of the report. In addition, the writer often states who 
authorized or commissioned the report and acknowledges any assistance 
he or she received in carrying out the project. The letter of transmittal is 
attached to the report, bound in with it, or simply placed on top of it. Even 
though the letter likely contains little information that is not included else- 
where in the report, it is important because it is the first thing the reader 
sees. It establishes a courteous and professional tone. Letters of transmittal 
are customary even when the writer and the reader both work for the same 
organization. See page 488 in the sample recommendation report for an 
example of a transmittal letter in the form of a memo. 

Cover Although some reports do not have covers, reports that will be han- 
dled a lot or that will be exposed to harsh environmental conditions, such as 
water or grease, often do. The cover usually contains the title of the report, 
the name and position of the writer, the date of submission, and the name 
or logo of the writer’s company. Sometimes the cover also includes a security 
notice or a statement of proprietary information. 

Title Page A title page includes at least the title of the report, the name of 
the writer, and the date of submission. A more complex title page might also 
include a project number, a list of additional personnel who contributed to 
the report, and a distribution list. See page 490 in the sample recommenda- 
tion report for an example of a title page. 

Abstract An abstract is a brief technical summary of the report, usually no 
more than 200 words. It addresses readers who are familiar with the techni- 
cal subject and who need to decide whether they want to read the full report. 
In an abstract, you can use technical terminology and refer to advanced 
concepts in the field. Abstracts are sometimes published by abstract services, 
which are useful resources for researchers. 

Abstracts often contain a list of half a dozen or so keywords, which are 
entered into electronic databases. As the writer, one of your tasks is to think 
of the various keywords that will lead people to the information in your 
report. 


For more about formatting a letter, 
seeCh. 14, p.363. 


For more about abstract services, see 
Ch. 6, p. 123. 
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There are two types of abstracts: descriptive and informative. A descrip- 
tive abstract — sometimes called a topical, indicative, or table-of-contents 
abstract — describes the kinds of information contained in the report. It does 
not provide the major findings (important results, conclusions, or recom- 
mendations). It simply lists the topics covered, giving equal emphasis to 
each. Figure 18.4 is a descriptive abstract from a report by a utility company 
about its pilot program for measuring how much electricity its customers are 
using. A descriptive abstract is used most often when space is at a premium. 
Some government proposals, for example, call for a descriptive abstract to be 
placed at the bottom of the title page. 

An informative abstract presents the major findings. If you don’t know 
which kind of abstract the reader wants, write an informative one. 

The distinction between descriptive and informative abstracts is not 
clear-cut. Sometimes you might have to combine elements of both in a 
single abstract. For instance, if there are 15 recommendations — far too 
many to list — you might simply note that the report includes numerous 
recommendations. 

See page 491 in the sample recommendation report for an example of an 
informative abstract. 

Table of Contents The table of contents, the most important guide to 
navigating the report, has two main functions: to help readers find the infor- 
mation they want and to help them understand the scope and organization 
of the report. 

A table of contents uses the same headings as the report itself. There- 
fore, to create an effective table of contents, you must first make sure that 
the headings are clear and that you have provided enough of them. If the 


This abstract is descriptive rather 
than informative because it does 
not present any of the major data 
from the survey or present the rec- 
ommendations that are mentioned 
in the final sentence. 


Abstract 

"Design of a Radio-Based System for Distribution Automation" 
by Brian D. Raven 

A new survey by the Maryland Public Service Commission suggests that utilities have 
not effectively explained to consumers the benefits of smart meters. The two-year study 
of 86,000 consumers concludes that the long-term benefits of smart meters will not 
be realized until consumers understand the benefits of shifting some of their power 
usage to off-peak hours in response to the data they receive from their meters. The 
study presents recommendations for utilities and municipal governments to improve 
customer understanding of how to use the smart meters effectively. 

Keywords: smart meters, distribution systems, load, customer attitudes, power 
consumption, utilities, Maryland Public Utilities Commission 


FIGURE 18.4 Descriptive Abstract 
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table of contents shows no entry for five or six pages, you probably need 
to partition that section of the report into additional subsections. In fact, 
some tables of contents have one entry, or even several, for every report 
page. 

The following table of contents, which relies exclusively on generic 
headings (those that describe an entire class of items), is too general to be 
useful. 


Table of Contents 


Introduction 1 

Materials 3 

Methods 4 • This methods section, which goes 

Results 1 9 from page 4 to page 18, should 

Recommendations 23 have subentries to break up the 

References 26 text an< ^ t0 help rea ders find the 

Appendixes information they seek. 


For more-informative headings, combine the generic and the specific: 

Recommendations: Five Ways to Improve Information-Retrieval Materials Used in the 
Calcification Study 

Results of the Commuting-Time Analysis 

Then build more subheadings into the report itself. For instance, for the 
“Recommendations” example above, you could create a subheading for each 
of the five recommendations. Once you have established a clear system of 
headings within the report, use the same text attributes — capitalization, 
boldface, italics, and outline style (traditional or decimal) — in the table of 
contents. 

When adding page numbers to your report, remember two points: 

• The table of contents page does not contain an entry for itself. 

• Front matter is numbered using lowercase Roman numerals (i, ii, and so 
forth), often centered at the bottom of the page. The title page of a report 
is not numbered, although it represents page i. The abstract is usually 
numbered page ii. The table of contents is usually not numbered, although 
it represents page iii. The body of the report is numbered with Arabic 
numerals (1, 2, and so on), typically in the upper outside corner of the 
page. 

See page 492 in the sample recommendation report for an example of a table 
of contents. 

List of Illustrations A list of illustrations is a table of contents for the fig- 
ures and tables. List the figures first, then the tables. (If the report contains 
only figures, call it a list of figures. If it contains only tables, call it a list of 


For more about text attributes, see 
Ch. 1 1, p. 265. 
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► TECH TIP 


HowTo Format Headers, Footers, and 
Page Numbers 

In writing a report, you might want to use different headers, 
footers, and page-numbering schemes and styles in different 
sections of the report. To do this, you create different sections 
in your Word file. Within each section, you can modify the 
headers, footers, and page numbers by using the Header & 
Footer group. 



page numbers by double-clicking 

the header or footer in Print Layout View and using the 
groups on the Design tab. 



The Options group enables 

you to specify different ► 

headers and footers for 
odd and even pages, as well 
as the first page. 

The Page Number drop-down 
menu enables you to change 
the format of page numbers.^^. 


13 Different First Page 
Q Different Odd & Even Pages 
0 Show Document Text 
Options 


Id Page Number fc Timt g)C 
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► TECH TIP 


How To Create a Table of Contents 


You can make a table of contents automatically in Word. You 
can then use the Styles feature to format the headings in 
your report. 

Place your cursor where you want to create the table of 
contents. 


Use the Table of Contents drop-down menu in the Table 
of Contents group on the Reference tab to insert a table 
of contents with a built-in style. 

You may also select Insert 
Table of Contents to choose 
the format for the table of 
contents, select the level of 
detail to show, and preview 
the appearance of the table. 

If you select Insert Table 
of Contents, you can also 
modify the text attributes of 
the table levels to match the 
text attributes in your report. 

If you later change your 
report and its pagina- 
tion, you can update the 
page numbers or the 
entire table of contents 
by selecting the table 
of contents and then 
selecting Update Table 
of Contents. 


\ 


J . JJ Update TaOlt... 



Contents 

Understanding the 

Using a Problem-S 


In the Update Table of 
Contents dialog box, select 
the option you want: up- 
date page numbers only or 
update entire table. 



KEYWORDS: header & footer group, options group, header, 
footer, print layout view, design tab, page number, format page 
numbers 


KEYWORDS: table of contents, table of contents group, update 
table of contents 
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FIGURE 18.5 List of Illustrations 


tables.) You may begin the list of illustrations on the same page as the table 
of contents, or you may begin the list on a separate page and include it in the 
table of contents. Figure 18.5 shows a list of illustrations. 

Executive Summary The executive summary (sometimes called the 
epitome, executive overview, management summary, or management overview) is a 
brief condensation of the report addressed to managers. Most managers need 
only a broad understanding of the projects that an organization undertakes 
and how they fit together into a coherent whole. 

An executive summary for a report of under 20 pages is typically one page 
(double-spaced). For longer reports, the maximum length is often calculated 
as a percentage of the report, such as 5 percent. 

The executive summary presents information to managers in two parts: 

• Background. This section explains the problem or opportunity: what was 
not working or was not working effectively or efficiently, or what potential 
modification of a procedure or product had to be analyzed. 

• Major findings and implications. This section might include a brief 
description — only one or two sentences — of the methods, followed by a 
full paragraph about the conclusions and recommendations. 

An executive summary differs from an informative abstract. Whereas an 
abstract focuses on the technical subject (such as whether the public is tak- 
ing advantage of the data from smart electric meters), an executive summary 
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concentrates on the managerial implications of the subject for a particular 
company (such as whether PECO, the Philadelphia utility company, should 
carry out a public-information campaign to educate customers about how to 
use their smart meters). 


Follow these five suggestions in writing executive summaries. 

► Use specific evidence in describing the background. For most managers, the 
best evidence is in the form of costs and savings. Instead of writing that the 
equipment you are now using to cut metal foil is ineffective, write that the equip- 
ment jams once every 72 hours on average, costing $400 in materials and $2,000 
in productivity each time. Then add up these figures for a monthly or an annual 
total. 

► Be specific in describing research. For instance, research suggests that a com- 
puterized energy-management system could cut your company's energy costs 
by 20 to 25 percent. If the company's energy costs last year were $300,000, it 
could save $60,000 to $75,000. 

► Describe the methods briefly. If you thinkyour readers are interested, include a 
brief description of your methods — no more than a sentence or two. 

► Describe the findings according to your readers' needs. If your readers want 
to know your results, provide them. If your readers are unable to understand 
the technical data or are uninterested, go directly to the conclusions and 
recommendations. 

► Ask an outside reader to review your draft. Give the summary to someone who 
has no connection to the project. That person should be able to read your sum- 
mary and understand what the project means to the organization. 


See page 493 in the sample recommendation report for an example of an 
executive summary. 

WRITING THE BACK MATTER 

The back matter of a recommendation report might include the following 
items: glossary, list of symbols, references, and appendixes. 

Glossary and List of Symbols A glossary, an alphabetical list of defini- 
tions, is particularly useful if some of your readers are unfamiliar with the 
technical vocabulary in your report. Instead of slowing down your discussion 
by defining technical terms as they appear, you can use boldface, or some 
similar method of highlighting words, to indicate that the term is defined in 


4 \ 



Writing an Executive Summary 
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DOCUMENT ANALYSIS ACTIVITY 


Analyzing an Executive Summary 


Executive Summary 

On May 1 1, we received approval to study whether Android smartphones 
could help our 20 engineers receive email, monitor their schedules, take 
notes, and access reference sources they need in the field. In our study, we 
addressed these problems experienced by many of our engineers: 

• They have missed deadlines and meetings and lost client information. 

• They have been unable to access important files and reference materials 
from the field. 

• They have complained about the weight — sometimes more than 40 
pounds — of the binders and other materials that they have to carry. 

• They have to spend time keyboarding notes that they take in the field. 

In 2014, missed meetings and other schedule problems cost the company 
over $400,000 in lost business. And our insurance carrier settled a claim for 
$50,000 from an engineer who experienced back and shoulder problems 
due to the weight of his pack. 

We researched the capabilities of Android smartphones, then established 
these criteria for our analysis: 

• The device must weigh less than 5 ounces. 

• It must run on Android 4.2.2 or higher. 

• It must have at least 2GB RAM. 

• It must have at least a 1 ,9-GHz Quad Core. 

• It must have a microSD slot. 

• It must have at least a 4-inch screen. 

• It must have a camera with a resolution of 1 0.0MP or better. 

• It must have on-device encryption. 

• It must be Microsoft Office compatible. 

• It must cost $700 or less. 

On the basis of our analysis, we recommend that the company purchase 
20 Samsung Galaxy 4 smartphones, for a total cost of $1 2,980. These 
devices best meet all our technical and cost criteria. 


This executive summary comes 
from a corporate report on pur- 
chasing Android smartphones 
for employees. The questions 
below ask you to think about 
the discussion of executive 
summaries (beginning on 
p. 483). 

1. How clearly do the writers 
explain the background? 
Identify the problem or 
opportunity they describe in 
this executive summary. 

2 . Do the writers discuss the 
methods? If so, identify the 
discussion. 

3 . Identify the findings: the 
results, conclusions, and 
recommendations. How 
clearly have the writers 
explained the benefits to 
the company? 
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DOCUMENT ANALYSIS ACTIVITY 


To analyze a recommendation report presented as a pod- 
cast, go to "Document Analysis Activities" under "Additional 
Resources" in Ch. 18: macmillanhighered.com/launchpad 
/techcommlle. 



Influenza 201 0-201 1 : ACIP Vaccination 
Recommendations 

Source: Centers for Disease Control and Prevention, 2008: 
http://www2c.cdc.gov/podcasts/player.asp?f=3266054. 


the glossary. The first time a boldfaced term appears, explain this system in 
a footnote. For example, the body of the report might say, “Thus the positron* * 
acts as the ...” while a note at the bottom of the page explains: 

*This and all subsequent terms in boldface are defined in the Glossary, page 26. 

Although a glossary is usually placed near the end of the report, before the 
appendixes, it can also be placed immediately after the table of contents if 
the glossary is brief (less than a page) and if it defines essential terms. Figure 
18.6 shows an excerpt from a glossary. 

A list of symbols is formatted like a glossary, but it defines symbols and 
abbreviations rather than terms. It, too, may be placed before the appendixes 
or after the table of contents. Figure 18.7 shows a list of symbols. 

References Many reports contain a list of references (sometimes called 
a bibliography or list of works cited) as part of the back matter. References 
and the accompanying textual citations throughout the report are called 
documentation. Documentation acknowledges your debt to your sources, 
establishes your credibility as a writer, and helps readers locate and review 
your sources. See Appendix, Part B, for a detailed discussion of documenta- 
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Glossary 

Applicant: A state agency, local government, or eligible private nonprofit organization 
that submits a request to the Grantee for disaster assistance under the state’s grant. 

Case Management: A systems approach to providing equitable and fast service to 
applicants for disaster assistance. Organized around the needs of the applicant, the 
system consists of a single point of coordination, a team of on-site specialists, and a 
centralized, automated filing system. 

Cost Estimating Format (CEF): A method for estimating the total cost of repair for 
large, permanent projects by use of construction industry standards. The format 
uses a base cost estimate and design and construction contingency factors, applied 
as a percentage of the base cost. 

Declaration: The President’s decision that a major disaster qualifies for federal 
assistance under the Stafford Act. 

Hazard Mitigation: Any cost-effective measure that will reduce the potential for 
damage to a facility from a disaster event. 



FIGURE 18.6 Glossary 


tion. See page 510 in the sample recommendation report for an example of 
a reference list. 

Appendixes An appendix is any section that follows the body of the report 
(and the glossary, list of symbols, or reference list). Appendixes (or appendices) 
convey information that is too bulky for the body of the report or that will 
interest only a few readers. Appendixes might include maps, large technical 
diagrams or charts, computations, computer printouts, test data, and texts of 
supporting documents. 

Appendixes, usually labeled with letters rather than numbers (Appendix 
A, Appendix B, and so on), are listed in the table of contents and are referred 
to at appropriate points in the body of the report. Therefore, they are acces- 
sible to any reader who wants to consult them. See page 511 in the sample 
recommendation report for an example of an appendix. 


List of Symbols 


p 

beta 

CRT 

cathode-ray tube 

y 

gamma 

Hz 

hertz 

rcvr 

receiver 

SNR 

signal-to-noise ratio 

uhf 

ultra high frequency 

vhf 

very high frequency 


FIGURE 18.7 List of 
Symbols 


Sample Recommendation Report 

The following example is the recommendation report on the tablet project 
proposed in Chapter 16 on page 436. The progress report for this project 
appears in Chapter 17 on page 454. 
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WRITING RECOMMENDATION REPORTS 


Transmittal "letters" can be pre- 
sented as memos. 


The writers include their titles and 
that of their primary reader. This 
way, future readers will be able 
to readily identify the reader and 
writers. 


The subject heading indicates the 
subject of the report (the tablet 
study at RRMC) and the purpose 
of the report (recommendation 
report). 


The purpose of the study. Notice 
that the writers link the recom- 
mendation report to the proposal, 
giving them an opportunity to state 
the main tasks they carried out in 
the study. 


The methods the writers used to 
carry out the research. 


The principal findings: the results 
and conclusions of the study. Notice 
that the writers state that they can- 
not be sure whether the technical 
information they have found is 
accurate. Is it okay to state that you 
are unsure about something? Yes, as 
long as you then propose a way to 
become sure about it. 



Rawlings Regional Medical Center 
7500 Bannock Avenue 
Rawlings, MT 59211 


Date: 

To: 


From: 


Subject: 


December 14, 2013 
Jill Bremerton, M.D. 

Chief Executive Officer 
^wling_sjlegional Medical Center 
Jeremy Elkins, Director of Information Technology 
Eloise Carruthers, Director of Nursing 
Rawlings Regional Medical Center 
Recommendation Report for the Tablet Study at RRMC 


Attached is the report for our study, "Selecting a Tablet Computer for the 
Clinical Staff at Rawlings Regional Medical Center: A Recommendation 
Report."We completed the tasks described in our proposal of October 6, 
2013: familiarizing ourselves with tablet use by clinical staff in hospitals 
across the country, assessing RRMC clinical staff's knowledge of and 
attitudes toward tablet use, studying different models for administering 
tablet use, determining the criteria by which we might evaluate tablets, 
and performing the evaluations. 

To carry out these tasks, we performed secondary and primary research. 
We studied the literature on tablet use, distributed a questionnaire to 
RRMC clinical staff who own tablets, and interviewed Dr. Bremerton. Then, 
we collected and analyzed our data and wrote the report. 

Our main findings are that the clinical staff who already own tablets are 
very receptive to the idea of using tablets in a clinical setting and slightly 
prefer having the hospital supply the tablets. We, too, think the hospital- 
supplied model is preferable to the bring-your-own-device (BYOD) 
model. Although the best tablets for our needs would be those designed 
and built for health-care applications, those are too expensive for our 
budget. Because reports on the technical characteristics of computer 
products are notoriously unreliable, we cannot be sure whether the many 
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Letter to Jill Bremerton, M.D. 

December 1 4, 201 3 
page 2 

general-purpose tablets can meet our standards for ease of disinfection or 
durability, and we are not sure whether they have sufficient battery life. 

We recommend one of two courses of action: reconsidering the cost 
criterion or testing a representative sample of general-purpose tablets for 
disinfection and the other technical characteristics and letting the clinical 
staff try them out. 

We appreciate the trust you have shown in inviting us to participate in this 
phase of the feasibility study, and we would look forward to working with 
you on any follow-up activities. If you have any questions or comments, 
please contact Jeremy Elkins, atjelkins@rrmc.org or at 444-3967, or Eloise 
Carruthers, at ecarruthers@rrmc.org or at 444-3982. 


The major recommendation. The 
writers ask their supervisor if she 
will reconsider whether the hos- 
pital can afford tablets specifically 
designed for health-care environ- 
ments. That's not insubordination. 
Just be polite about it. 

A polite offer to participate further 
or to provide more information. 
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WRITING RECOMMENDATION REPORTS 


A good title indicates the subject 
and purpose of the document. One 
way to indicate the purpose is to 
use a generic term — such as analy- 
sis, recommendation, summary, or 
instructions — in a phrase following 
a colon. For more about titles, see 
Ch.9, p. 193. 


The names and positions of the 
principal reader and the writers of 
the document. 


The date the document was 
submitted. 


The name or logo of the writers' 
organization often is presented at 
the bottom of the title page. 


Selecting a Tablet Computer for 
the Clinical Staff at 
Rawlings Regional Medical Center: 
A Recommendation Report 


Prepared for: Jill Bremerton, M.D. 

Chief Executive Officer 
Rawlings Regional Medical Center 

Prepared by: Jeremy Elkins, Director of Information Technology 

Eloise Carruthers, Director of Nursing 


December 14, 201 3 



Rawlings Regional Medical Center 
7500 Bannock Avenue 
Rawlings, MT 59211 
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Abstract 

"Selecting a Tablet Computer for the Clinical Staff 
at Rawlings Regional Medical Center: 

A Recommendation Report" 

Prepared by: Jeremy Elkins, Director of Information Technology 
Eloise Carruthers, Director of Nursing 

On October 8, 201 3, Dr. Jill Bremerton, Chief Executive Officer of Rawlings 
Regional Medical Center (RRMC), approved a proposal by Jeremy Elkins 
(Director of Information Technology) and Eloise Carruthers (Director of 
Nursing) to carry out a feasibility study on integrating tablet computers 
into the RRMC clinical setting and to report their findings. The authors 
began by performing research to better understand how tablets are beincj' 
used by clinical staff in hospitals across the country. Then, they assessed 
RRMC clinical staff attitudes toward tablet use, studied two models for 
administering use of tablets in hospitals, determined the criteria by which 
tablets might be evaluated, and performed the evaluations. RRMC clinical 
staff who already own tablets are very receptive to the idea of using 
tablets in a clinical setting and slightly prefer having the hospital supply 
the tablets. The best tablets for RRMC needs are those designed and 
built for health-care applications because they meet hospital standards 
for disinfection, are durable, and offer numerous hardware and software 
options, such as barcode scanners, RFID readers, speech input, and 
smart-card readers. Unfortunately, they are too expensive for our budget. 
Because there are numerous health-care apps available for not only the 
iPad but also the many Android tablets and Windows-based tablets, any 
of these that meet our other needs would be acceptable. However, we 
are not sure whether the many general-purpose tablets can meet our 
standards for ease of disinfection or ruggedness, and we are not sure 
whether they have sufficient battery life. We recommend that, if we cannot 
reconsider the cost criterion, we test a representative sample of general- 
purpose tablets for disinfection and the other technical characteristics 
that would affect their usefulness in the clinical setting. 

Keywords: tablets, health care, HIPAA, disinfection, iPad, Android, 

Windows, rugged, durability 

ii 


In the abstract, the title of the 
report is often enclosed in quota- 
tion marks because the abstract 
might be reproduced in another 
context (such as in a database), in 
which case the report title would be 
the title of a separate document. 


Abstracts are often formatted as a 
single paragraph. 

The background and purpose of the 
report. 


The methods. 


The major findings. 


Note that the writers provide some 
technical information about tablet 
use, clinical staff attitudes, and tech- 
nical characteristics of tablets. 


The major recommendations. 


A keywords list ensures that the 
report will appear in the list of 
results of an electronic search on 
any of the terms listed. 
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WRITING RECOMMENDATION REPORTS 


Note that the typeface and design 
of the headings in the table of 
contents mirror the typeface and 
design of the headings in the report 
itself. 


In this table of contents, the two 
levels of headings are distinguished 
by type style (boldface versus italic) 
and indentation. 


Table of Contents 

Executive Summary 1 

Introduction 2 

Research Methods 4 

Task 1. Acquire a basic understanding of tablet use by clinical staff 

across the nation 4 

Task 2: Determine the RRMC clinical staff's knowledge of and 

attitudes toward tablet use 5 

Task 3. Assess the BYOD and hospital-owned tablet models 6 

Task 4: Establish criteria for evaluating tablets 6 

Task 5. Assess available tablets based on our criteria 7 

Task 6. Analyze our data and prepare this recommendation report 7 

Results 8 

Task 1. Acquire a basic understanding of tablet use by clinical staff 

across the nation 8 

Task 2: Determine the RRMC clinical staff's knowledge of and 

attitudes toward tablet use 9 

Task 3. Assess the BYOD and hospital-owned tablet models 1 0 

Task 4: Establish criteria for evaluating tablets 12 

Task 5. Assess available tablets based on our criteria 1 3 

Conclusions 15 

Tablet use by clinical staff. 1 5 

The RRMC clinical staff's knowledge of and attitudes toward 

tablet use 1 5 

The BYOD and hospital-owned tablet models 1 5 

Criteria for evaluating tablets 1 5 

Assessing available tablets based on our criteria 1 6 

Recommendation 1 7 

Option 1: Reconsider the cost criterion 1 7 

Option 2: Test a representative sample of general-purpose tablets 1 7 

References 1 8 

Appendix: Clinical-Staff Questionnaire 1 9 
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Executive Summary 

To determine the best way to integrate tablet computers into the RRMC 
clinical setting, Dr. Jill Bremerton, Chief Executive Officer, asked us to study 
national trends, determine clinical-staff attitudes, examine management 
models, devise criteria for assessing tablets, and present our findings and 
recommendations. 

Currently, RRMC has no formal policy on tablet usage by clinical staff. By 
default, we are following a bring-your-own-device (BYOD) approach. More 
than half of our clinical staff already use their personal tablets in their work. 

Dr. Bremerton wanted us to determine the best way to make tablets available 
to all our clinical staff. This charge included assessing the available tablets and 
recommending which tablet we should make available to our clinical staff. 

To carry out this study, we completed the tasks described in our proposal 
of October 6, 201 3: we studied the literature on tablet use; distributed 
a questionnaire to every member of the RRMC clinical staff, requesting 
responses from those who own tablets; and interviewed Dr. Bremerton. Then, 
we collected and analyzed our data and wrote the report. 

Our main finding is that the clinical staff who already own tablets are very 
receptive to the idea of using tablets in a clinical setting. Not one of these staff 
members thought we should not use tablets in the clinical setting. By a slight 
margin, these staff members prefer having the hospital supply the tablets. 

We, too, think the hospital-supplied model is preferable to the BYOD model 
because it will reduce the chances of privacy violations and streamline the 
work of the IT department. We concluded, too, that the best tablets for our 
needs are those designed and built for health-care applications. Unfortunately, 
they are too expensive for our budget. And we cannot be sure, simply from 
reading the literature, whether the many general-purpose tablets can meet 
our standards for ease of disinfection or durability. Nor can we be sure whether 
they have sufficient battery life. Any of the general-purpose tablets, regardless 
of operating system or brand, would be adequate if it met these standards. 

We recommend one of two courses of action: reconsidering our cost criterion 
or testing a representative sample of general-purpose tablets for disinfection 
and the other technical characteristics and making suitable tablets available 
for clinical staff to demo. We believe reconsidering the cost criterion is the 
better approach for our needs because the health-care-specific tablets offer 
significant advantages over the general-purpose tablets. 


The executive summary describes 
the project with a focus on the 
managerial aspects, particularly the 
recommendation. Note the writers' 
emphasis on the problem at RRMC. 

Here the writers present a brief 
statement of the subject of their 
report. 


The background of the feasibility 
study that Dr. Bremerton is funding. 

A brief statement of the methods 
the writers used to carry out their 
research. Note that throughout this 
report the writers use the active 
voice ("We studied the literature 
...”). SeeCh. 10, p. 231 for more on 
the active voice. Note, too, that the 
discussion of the methods is brief: 
most managers are less interested 
in the details of the methods you 
used than in your findings. 

f 

Findings are the important results 
and conclusions of a study. 

/ Note that the writers use the word 
recommend. Using key generic 
terms such as problem, methods, 
results, conclusions, and recommen- 
dations helps readers understand 
the role that each section plays in 
the document. 


Because the executive summary is 
the report element addressed most 
directly to management, the writers 
make clear why they prefer looking 
again at whether the hospital can 
afford to purchase health-care- 
specific tablets. 
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Some organizations require that 
each first-level heading begin on a 
new page. 

A brief statement of the context for 
the report. 


Note that the word currently is used 
to introduce the background of the 
study: the current situation is unsat- 
isfactory for several reasons. 


A formal statement of the task the 
committee was asked to perform. 
The writers paraphrase from the 
memo Dr. Bremerton gave them. 
Often in technical communication, 
you will quote or paraphrase words 
your reader wrote to you. This 
practice reminds the reader of the 
context and shows that you are car- 
rying out your tasks professionally. 


The writers incorporate a brief 
overview of their methods into the 
list of tasks. 


The writers devote two paragraphs 
to their principal findings. The 
introduction can present the major 
findings of a report; technical com- 
munication is not about drama and 
suspense. 


2 

• Introduction 

To determine the best course of action for integrating tablet computers 
into the RRMC clinical setting, Dr. Jill Bremerton, RRMC Chief Executive 
Officer, asked us to study national trends, determine clinical-staff 
knowledge of and attitudes toward tablets, examine administrative 
models for tablet use, devise criteria for assessing tablets, and present our 
findings and recommendations. 

Currently, RRMC has no formal policy on tablet usage by clinical staff. By 
default, we are following a bring-your-own-device (BYOD) approach. More 
than half of our clinical staff use their personal tablets in their work. This 
situation is not ideal because not all clinical staff are taking advantage of 
the enormous potential for improving patient care and reducing costs 
by using tablets, and IT is struggling to keep up with the work needed 
to ensure that all the different tablets are working properly and that any 
information-security protocols required by HIPAA and the Affordable Care 
Act are not being violated. 

Therefore, Dr. Bremerton wanted us to determine the best way to make 
tablets available to all our clinical staff. Specifically, Dr. Bremerton asked us 
to perform five tasks: 

• Determine how tablets are being used by clinical staff across the nation. 

We performed secondary research to complete this task. 

• Determine the RRMC clinical staff's current knowledge of and attitudes 
toward tablet use. To complete this task, we wrote and distributed a 
survey to clinical staff who already own tablets. 

• Determine how hospitals administer the use of tablets in a clinical 
setting. We performed secondary research to complete this task. 

• Establish criteria by which we might evaluate tablets for RRMC. We 
performed secondary research to complete this task. In addition, 
we interviewed Dr. Bremerton for her suggestions about the most- 
important criterion. 

• Assess available tablets based on our criteria. We performed secondary 
research to complete this task. 

We found that tablet use in clinical settings is increasing quickly, and that 
clinical staff are finding many ways to use tablets to improve care and 
save time and money. Among the clinical staff at RRMC who already own 
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tablets, nearly half own an iPad and nearly half an Android tablet, most 
consider themselves expert users of their tablets, and more than two- 
thirds already use them in the clinical setting; by a slim margin, they would 
prefer a hospital-supplied model for tablet use to a BYOD model. Our 
research on the two models for making tablets available also found more 
advantages and fewer disadvantages to the hospital-supplied model. 

Our principal finding regarding tablets themselves is that the best 
tablets for our use would be those designed and built for health-care 
applications. These tablets are rugged and easy to disinfect, and they offer 
a wealth of hardware and software options that would streamline our 
daily tasks without introducing any risks either to patient care or to data 
privacy. Unfortunately, purchasing enough of these tablets for all clinical 
staff would exceed our budget. To determine whether any of the general- 
purpose tablets meet all our needs, we would need to conduct hands-on 
testing regarding disinfection, battery life, durability, and several other 
technical criteria. 

We recommend, first, that we reassess whether the budget will permit 
consideration of any of the health-care-specific tablets. If that is not 
possible, we recommend that we ask manufacturers of a small set of 
general-purpose tablets to let us test their products and invite our clinical 
staff to demo them. This option would yield data that would help us 
decide how to proceed. 

In the following sections, we provide additional details about our research 
methods, the results we obtained, the conclusions we drew from those 
results, and our recommendation. 


Notice the writers' use of the phrase 
"we recommend." Repeating key 
terms in this way helps readers 
understand the logic of a report 
and concentrate on the technical 
information it contains. 


An advance organizer for the rest of 
the report. 
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The writers use the same task 
organization as in the proposal and 
the progress report. 


4 

Research Methods 

We began our research by interviewing Dr. Bremerton, who emphasized 
that we need to maintain our focus on our priorities — patient care and 
service to the community — and not let technical questions about the 
tablets distract us from the needs of our clinical staff. "We're not going to 
do anything without the approval of the doctors and nurses," she said. 

Early on in our research, we discovered an article that corroborated what 
Dr. Bremerton had told us (Narisi, 201 3). Two keys to doing the research 
were to focus on security features — data-privacy issues mandated in 
HIPAA and in the Affordable Care Act — and to get the clinical staff's input. 

To perform the analysis requested by Dr. Bremerton, we broke the project 
into six tasks: 

1 . acquire a basic understanding of tablet use by clinical staff across the 
nation 

2. determine the RRMC clinical staff's knowledge of and attitudes toward 
tablet use 

3. assess the BYOD and hospital-owned tablet models 

4. establish criteria for evaluating tablets 

5. assess available tablets based on our criteria 

6. analyze our data and prepare this recommendation report 

In the following discussion of how we performed each task, we explain the 
reasoning that guided our research. 

Task 7 . Acquire a basic understanding of tablet use by clinical staff across 
the nation 

Dr. Bremerton pointed us to a number of resources on tablet use in clinical 
settings. In addition, we conducted our own literature review. Most of the 
research we studied fell into one of four categories: 

• general introductions to tablet use in trade magazines and general- 
interest periodicals 

• more-focused articles about tablets used in health care 

• technical specifications of tablets provided in trade magazines and on 
manufacturers' websites 

• trade-magazine articles about best practices for managing the use of 
tablets in clinical settings 
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As we expected, the information we acquired was a mix of user opinions, 
benchmark-test results, and marketing. We relied most heavily on case 
studies from hospital administrators and technical specialists in health IT. 
Because of the unreliability of information on manufacturers' websites, we 
were hesitant to rely on claims about product performance. 

Task 2: Determine the RRMC clinical staff's knowledge of and attitudes 
toward tablet use 

On October 14, 2013, we sent all 147 clinical staff members an email 
linking to a four-question Qualtrics survey. The email indicated that we 
were seeking opinions about tablet use by clinical-staff members who 
already own tablets and made clear that the survey would take less than 
two minutes to complete. 

Initially, we considered collecting data from all 147 clinical staff members. 
However, as we constructed that survey, we realized that it would be 
cumbersome to gather and track information from three different 
populations: those who didn't own a tablet, those who owned one but 
didn't use it in the clinic, and those who owned one and did use it in the 
clinic. Eliciting information from these different groups would require a 
long, complex questionnaire and some statistical analysis to separate out 
the attitudes. 

For this reason, we decided to address only the tablet owners, since we 
assumed that this group would constitute approximately two-thirds of the 
clinical staff (Drinkwater, 201 3). With this streamlined focus, we were able 
to create a very brief survey, one that would likely yield a high return rate. 
We assumed, too, that the opinions expressed by current tablet owners 
would likely be of more value in helping us plan a formal program of 
tablet use than those of clinicians who were less likely to be experienced 
tablet users. 

We field-tested the questionnaire with six clinical staff members, revised 
one of the questions, and then, with the authorization of Dr. Bremerton, 
uploaded the questionnaire to Qualtrics and sent an email to the clinical 
staff. 

The questionnaire (including the responses) appears in the Appendix, 
page 1 9. 


By stating that they know that their 
sources are a mixture of different 
kinds of information, not all of 
which is equally useful for every 
kind of question that needs to be 
answered, the writers suggest that 
they are careful analysts. 


The writers carefully explain the 
logic of their methods. Do not 
assume that your readers will auto- 
matically understand why you did 
what you did. Sometimes it is best 
to explain your thinking. Although 
technical communication contains 
a lot of facts and figures, like other 
kinds of writing it relies on clear, 
logical arguments. 


A s discussed in Ch. 6, page 1 38, 
some questions will misfire. There- 
fore, it is smart to field-test a ques- 
tionnaire before you distribute it. 


Including a page number in the 
cross reference to the appendix is 
a convenience to the reader. When 
you do so, remember to add the 
correct page number after you 
determine where the appendix (or 
the several appendixes) will appear 
in the report. 
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Note that the writers present their 
references to their sources through- 
out the report. 

Here, again, the writers explain 
the logic of their methods. They 
decided to rely on the experiences 
of hospital administrators. This 
approach will likely appeal to Dr. 
Bremerton. 


Often you will begin your project 
with a cost criterion: your recom- 
mended solution must not cost 
more than a certain amount. 


The writers present just enough 
information about the technologies 
to help the reader understand their 
logic. Writers sometimes present 
too much information; include only 
as much as your readers need to be 
able to follow your report. 


Task 3. Assess the BYOD and hospital-owned tablet models 
Our research revealed that hospitals use one of two administrative models 
for giving clinical staff access to tablets: the bring-your-own-device 
(BYOD) model and purchasing tablets to distribute to staff. To present 
the advantages and disadvantages of each of these models, we relied 
on reports from hospital administrators who pioneered these models 
(Jackson, 201 la, 201 1 b). For statistics on the popularity of each of these 
administrative models, we relied on a survey (Terry, 2011). 

Task 4: Establish criteria for evaluating tablets 
We both studied the voluminous literature on tablets. Jeremy Elkins 
met informally with his five IT colleagues to discuss the data, and Eloise 
Carruthers met informally with her nursing staff and with selected 
physicians, including several who had responded to the survey. 

We began with the first criterion: cost. Dr. Bremerton had told us in our 
interview that the budget for the project (assuming that RRMC would 
supply a tablet to each of the 147 members of the clinical staff) would be 
$800 per device, fully configured with any commercial software needed to 
operate it. For this reason, we did not conduct a thorough examination of 
the health-care-specific tablets, each of which costs $2,500-3,000. 

In addition, we paid particular attention to the complexities of the current 
tablet market, focusing on whether the various devices would work 
seamlessly with our health-records system and other security features 
("Top Five," 201 3), on the need to be able to disinfect the tablets (Carr, 

201 1), and on durability (Narisi, 201 3). We knew from experience with all 
kinds of portable information technology that the question of battery life 
would be problematic because it can vary so much depending on load 
and other factors. 

We concluded that two factors that might seem critically important were 
not: operating system and availability of relevant apps. Although the 
Apple iPad is the single most popular tablet, the Samsung Galaxy and 
other Android tablets are currently outselling iPads. As a result, all the 
important apps are being created for the Apple operating system (iOS), for 
Android, and for Windows (the OS used by the Microsoft Surface and the 
major health-care-specific tablets). 
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Task 5. Assess available tablets based on our criteria 

Because our budget did not permit us to recommend the tablets designed 

for the health-care industry, we decided not to study them in detail. 

To study the general-purpose tablets, we relied on trade magazines. We 
soon realized, however, that several of our necessary criteria — namely, the 
ability to disinfect the tablet, as well as durability and battery life — were 
not adequately addressed in the literature because our needs as a hospital 
are so specific. 

For instance, battery life is typically reported as the mean number of hours 
the battery will last. But that figure varies significantly, depending on the 
applications the device is running. In addition, there is the question of 
whether the device is hot-swappable (that is, whether the battery can be 
replaced without shutting down the device). However, some tablets boot 
very quickly, making this characteristic less important. Finally, there is an 
administrative question: will the clinical staff member use the same tablet 
every day or check one out at the start of each shift (or perhaps check out 
a second or even a third one during a 14-hour shift)? Will fresh batteries 
be available only in one location, or can they be checked out at several 
locations? Can a staff member grab a handful of fresh batteries at the start 
of a shift? All these questions bear on how we would need to think about 
the importance of battery life. 

For this reason, we recommend that a representative sample of general- 
purpose tablets be evaluated for disinfection, durability, and battery 
life and that this study include a substantial on-site evaluation period at 
FSRMC. 

Task 6. Analyze our data and prepare this recommendation report • 

We drafted this report and uploaded it to a wiki that we created to make 
it convenient for the other IT staff members and interested clinical staff 
members to help us revise it. We incorporated most of our colleagues' 
suggestions and then presented a final draft of this report on the wiki to 
gather any final editing suggestions. 


Because analyzing their data and 
writing this report is part of the 
study, it is appropriate to include 
it as one of the steps. In some 
organizations, however, this task 
is assumed to be part of the study 
and is therefore not presented in 
the report. 
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Results 

In this section, we present the results of our research. For each of the tasks 
we carried out, we present the most important data we acquired. 

Task 7 . Acquire a basic understanding of tablet use by clinical staff across 
the nation 

Since the introduction of the Apple iPad in 2010, the use of tablets by 
clinical staff in hospitals across the country has been growing steadily. 
Although there are no precise statistics on how many hospitals either 
distribute tablets to clinical staff or let them use their own devices in 
their work, the number of articles in trade magazines, exhibits at medical 
conferences, and discussions on discussion boards suggests that tablets 
are quickly becoming established in the clinical setting. And many 
hundreds of apps have already been written to enable users to carry out 
health-care-related tasks on tablets. 

The most extensive set of data on tablets in hospitals relates to the use of 
the iPad, the first tablet on the market. Ottawa Hospital has distributed 
more than 1 ,000 iPads to clinical staff; California Hospital is piloting a 
program with more than 1 00 iPads for hospital use; Kaiser Permanente 
is testing the iPad for hospital and clinical workflow; and Cedars-Sinai 
Medical Center is testing the iPad in its hospital. The University of 
Chicago's Internal Medicine Residency Program uses the iPad; the iPad is 
also being distributed to first-year medical students at Stanford, University 
of California-lrvine, and University of San Francisco. In addition, there are 
reports of Windows-based and Android-based tablets being distributed at 
numerous other hospitals and medical schools (Husain, 201 1). 

Today, tablets have five main clinical applications (Carr, 201 1): 

• Monitoring patients and collecting data. Clinical staff connect tablets to 
the hospital's monitoring instruments to collect patient information 
and transfer it to patients' health records without significant human 
intervention. In addition, staff access patient information on their 
tablets. 

• Ordering prescriptions, authorizations, and refills. Clinical staff use tablets 
to communicate instantly with the hospital pharmacy and off-site 
pharmacies, as well as with other departments within the hospital, such 
as the Imaging Department. 
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• Scheduling appointments. Clinical staff use tablets to schedule doctor 
and nurse visits and laboratory tests, to send reminders, and to handle 
re-scheduling and cancellations. 

• Conducting research on the fly. Clinical staff use tablets to access 
medication databases and numerous reference works. 

• Educating patients. Clinical staff use videos and animations to educate 
patients on their conditions and treatment options. 

Tablets provide clinical staff with significant advantages. Staff do not need 
to go back to their offices to connect to the Internet or to the hospital's 
own medical-record system. Staff save time, reduce paper usage, and 
reduce transcription errors by not having to enter nearly as much data by 
hand. 

Task 2: Determine the RRMC clinical staff's knowledge of and attitudes * 

toward tablet use 

On October 14, 2013, we sent all 147 clinical staff members an email 
linking to a four-question Qualtrix survey. In the email, we said that we 
were seeking opinions about tablet use by clinical-staff members who 
already own tablets and made clear that the survey would take less than 
two minutes to complete. 

We received 96 responses, which represents 65 percent of the 147 staff 
members. We cannot be certain that all 96 respondents who indicated 
that they are tablet owners in fact own tablets. We also do not know 
whether all those staff members who own a tablet responded. However, 
given that some 75 percent of physicians in a 201 3 poll own tablets, we 
suspect that the 96 respondents reasonably accurately represent the 
proportion of our clinical staff who own tablets (Drinkwater, 2013). 

Here are the four main findings from the survey of tablet owners: 

• Some 47 percent of respondents own an Apple iPad, and 47 percent 
own either a Samsung Galaxy or another tablet that uses the Android 
operating system. Only 6 percent use the Microsoft Surface, one of the 
several Windows-based tablets. 

• Some 58 percent of the respondents strongly agree with the statement 
that they are expert users of their tablets. Overall, 90 percent agree more 
than they disagree with the statement. 


The writers continue to use the 
task structure that they used in the 
methods section. 
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• Some 63 percent of respondents use their tablets for at least one clinical 
application. They have either loaded apps on their tablets themselves or 
had IT do so for them. 

• Some 27 percent of the respondents would prefer to continue to use 
their own tablets for clinical applications, whereas 38 percent would 
prefer to use a tablet supplied by RRMC. Some 35 percent had no strong 
feelings either way. None of the respondents indicated that they would 
prefer not to use a tablet at all. 

Task 3. Assess the BYOD and hospital-owned tablet models 
Currently, hospitals use one of two models for giving clinical staff access 
to tablets: the bring-your-own-device (BYOD) model and the purchase 
model, whereby the hospital purchases tablets to distribute to staff. In this 
section, we will present our findings on the relative advantages of each 
model. 

The BYOD model is based on the fact that, nationally, some three-quarters 
of physicians already own tablets (with the Apple iPad the single most 
popular model) (Drinkwater, 201 3). We could find no data on how many 
nurses own tablets. 

The main advantage of the BYOD model is that clinical staff already know 
and like their tablets; therefore, they are motivated to use them and 
less likely to need extensive training. In addition, the hardware costs are 
eliminated (or almost eliminated, since some hospitals choose to purchase 
some tablets for staff who do not own their own). Todd Richardson, CIO 
with Deaconess Health System, Evansville, Indiana (Jackson, 201 1b), 
argues that staff members who own their own tablets use and maintain 
them carefully: they know how to charge, clean, store, and protect them. 

In addition, the hospital doesn't have to worry about the question of 
liability if staff members lose them during personal use. And if the staff 
member moves on to a new position at a different hospital, there is no 
dispute about who owns the information on the tablet. All the hospital 
has to do is disable the staff member's account. 

However, there are three main disadvantages to the BYOD model: 

• Some clinical staff do not have their own tablets, and some who do 
don't want to use them at work; to make the advantages of tablet use 
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available to all the clinical staff, therefore, the hospital needs to decide 
whether to purchase tablets and distribute them to these staff members. 

• Labor costs are high because each tablet needs to be examined carefully 
by the hospital IT department to ensure that it contains no software that 
might interfere with or be incompatible with the health-care software 
that needs to be loaded onto it. This labor-intensive assessment by IT 
can seriously erode the cost savings from not having to buy the tablet 
itself. 

• Chances of loss increase because the staff member is more likely to use 
the tablet at home as well as in the hospital. 

The other model for making tablets available to clinical staff is for the 
hospital to purchase the same tablet for each staff member. 

The purchase model offers two distinct advantages, as described by Dale 
Potter, CIO of 1 ,300-bed Ottawa Hospital in Ontario, Canada. Potter has 
purchased more than 2,000 iPads for his staff (Jackson, 201 1 a): 

• The hospital controls the software and apps loaded on the tablets and 
can even create its own apps. For instance, Potter hired 1 20 developers 
to create apps. 

• The hospital reduces labor costs because IT can load exactly the same 
set of apps and other software on each machine. Updates and upgrades 
also are far simpler to manage when all the devices are the same. 

The main disadvantages of the purchase model are the following: 

• Staff members might not like the tablet that the hospital chooses. 

• Staff members might need to be trained to use the tablet. 

• Liability issues related to loss of the tablets must be addressed officially 
in the employment contract between the hospital and the staff 
member. 

Beginning in 2010 with the introduction of the iPad, most hospitals 
used the BYOD model; clinical staff brought their own tablets to work 
and started to think about ways to use them in a clinical setting. As time 
passed, however, and more people began to acquire tablets from different 
manufacturers, hospitals began to see the advantages of standardizing 
tablet use. A 201 1 survey (Terry, 201 1) showed that 40 percent of hospitals 
use the BYOD model, whereas 55 percent of hospitals support only 
devices provided or owned by the institution. 
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Task 4: Establish criteria for evaluating tablets 

Our interview with Dr. Bremerton, as well as our research in the available 
literature, yielded four necessary criteria and three desirable criteria for 
tablet use at RRMC. 

A tablet that does not meet a necessary criterion would be eliminated 
from consideration. The four necessary criteria are the following: 

• Cost. Each device must cost less than $800, fully configured for use. 

• HIPAA compliance. We cannot use any device or technology that would 
jeopardize our compliance with the HIPAA and Affordable Care Act 
privacy standards for medical information. What this means, in essence, 
is that a tablet must operate seamlessly with our electronic health- 
records system, Cerner, which we access through our current utility, 
Citrix.The tablet must duplicate our current desktop and remote-access 
capabilities. 

• Other security features.The tablet must support basic security features, 
including encryption, remote wipe (IT's ability to remove data on a lost 
tablet), auto-lock (that cannot be turned off except by IT), and perimeter 
settings (IT's ability to prevent use of a tablet that has strayed a certain 
distance from the server) ("Top Five," 201 3). 

• Ease of disinfection. Because the tablets would be used in a clinical 
setting, they would be subject to the same standards of disinfection 
as any other equipment or device. A tablet that cannot be disinfected 
effectively and easily would not be an appropriate choice (Carr, 201 1). 

In addition, we have established four other criteria against which to 
evaluate tablets. We have deemed these criteria desirable; a tablet 
that does not meet a desirable criterion would not be eliminated from 
consideration. 

• Durability. Because the tablet would be carried around within the 
hospital and sometimes would be used in close quarters, it likely would 
be dropped or bumped. The more durable, the more desirable the tablet 
would be. 

• Long battery life. Our clinical staff routinely work shifts as long as 14 
hours. The longer the battery life, the better. Related to battery life is 
the hot-swap feature. In a hot-swappable device, the battery can be 
removed and replaced with a fresh one without having to shut down the 
tablet. 
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Task 5. Assess available tablets based on our criteria 

One challenge we faced is that it was impractical to do a comprehensive 

assessment of all of the approximately 100 tablets available on the market. 

A second challenge is that tablets fall into a dizzying variety of sometimes 
overlapping categories. For example, the single most popular tablet is the 
Apple iPad, which runs on Apple's proprietary operating system. Many other 
tablets run on the Android system. Some, like the Amazon Kindle Fire, run 
on specialized configurations of Android. And Microsoft's Surface runs on 
Windows. There are general-purpose tablets, like the Samsung, made for the 
consumer market, and there are specialized tablets, like the Motion, designed 
for the health-care industry (Phillips, 201 3). There are rugged tablets designed 
to meet military specifications for durability. Some tablets have USB ports 
for easy connection to existing clinical instruments and devices, as well as 
specialized features such as barcode-reading and RFID capabilities. Some 
tablets come with dozens of native (pre-installed) apps related to health care. 

In short, although many brands of tablet are similar, no two are identical. 

As a result, we decided to review a small set of tablets that are mentioned 
frequently in health-care magazines and journals. We were sure to include the 
iPad, the Microsoft Surface, and several Android tablets. We also looked briefly 
at several tablets specially designed and marketed for health-care applications. 

We present our basic findings by returning to our set of necessary and 
desired criteria. 


The four necessary criteria are the following: 

• Cost. Unfortunately, our cost criterion of $800 per unit eliminates all the 
tablets designed for health-care applications. These tablets, which cost 
between $2,500 and $3,000, are easy to disinfect and highly durable and 
include many desirable features such as barcode scanners, RFID readers, 
speech, and smart-card readers. The leading tablets in this category are 
the Proscribe Medical Tablet PC, the Sahara Slate PC, the MediSlate MCA, 
the Motion C5v Medical Tablet PC, theTeguarTA-10 Medical Tablet PC, the 
Advantech Medical PC, and the Arbor Antibacterial Medical Tablet. 

• HIPAA compliance. All of the tablets we reviewed would enable us to 
remain in compliance with HIPAA and ACA, and all would enable us to 
use our current record system, Cerner, through our Citrix utility. Some of 
the tablets have native apps to support this access, whereas others use 
virtual private networks. 
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• Other security features. All of the tablets we reviewed would support the 
basic security features we identified, although some tablets would be 
easier than others for IT to configure. 

• Ease of disinfection. This proved to be a very challenging criterion to assess. 

On the one hand, all of the so-called ruggedized tablets, as well as all 
those designed for health care, met this criterion because all the surfaces 
are sealed. On the other hand, the general-purpose tablets were not 
designed to withstand medical-grade disinfectants. However, this does 
not necessarily mean that they would not withstand clinical disinfection. 
According to John Curin, head of the health-care practice at Burwood, an 
IT consulting firm, "I couldn't disinfect [an iPad] if I wanted to." By contrast, 

Dr. John Halamka, the CIO of Beth Israel Deaconess Medical Center in 
Boston, argues that the iPad is "completely disinfectable."Even though 
Apple advises against using a disinfecting solution on the iPad, Halamka 
says he does so and has experienced no problems (Carr, 201 1). 

On the basis of the cost criterion, we must eliminate all the health-care- 
specific tablets and study only the general-purpose tablets. We need to 
devise a method to determine whether any of the general-purpose tablets 
can be adequately disinfected. For the purposes of this study, however, we 
decided to assess a representative subset of the general-purpose tablets 
based on our desirable criteria. 

We will now present our major findings regarding the desirable criteria: 
durability and long battery life. We have decided against presenting a 
decision matrix because some of the technical characteristics are either 
imprecise or unknowable. For instance, battery life is a notoriously difficult 
characteristic to measure, because it can be affected greatly by so many 
factors. 

Our tentative findings are that the Apple iPad, the Samsung Galaxy and 
the many other Android tablets, and the Microsoft Surface appear to 
meet our two desirable criteria. We would need to carry out our own 
tests of these tablets, configured with our software and appropriate 
apps, to determine their battery life. And we would need to determine 
whether any of the aftermarket protective cases would provide adequate 
durability. Rugged and waterproof iPad cases are available from Hard 
Candy Cases, OtterBod, and others. There are also waterproof solutions 
that are said to sterilize the iPad. In addition, there are some protective 
cases said to be designed specifically for clinical environments. 
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Conclusions • 

In this section, we present our conclusions based on our research related 
to the four questions we were asked to answer. 

Tablet use by clinical staff 

On the basis of our research, we conclude that increasing numbers of our 
clinical staff will begin to use tablets for more applications in a clinical 
setting. This increase will spur the creation of more health-care apps for all 
tablets. 


The RRMC clinical staff's knowledge of and attitudes toward tablet use 
On the basis of our survey of clinical staff who already own tablets, we 
conclude that they consider themselves proficient in using the tablets, 
and most already use them for at least one clinical application. Because 
they prefer the hospital-supplied model for tablet use, we conclude that 
they would welcome a formal plan to supply tablets. 

The BYOD and hospital-owned tablet models 
We conclude that the hospital-owned tablet model offers more 
advantages and fewer disadvantages than the BYOD model. Having all 
clinical staff use the same model of tablet saves money by streamlining 
the process of loading software and installing updates and upgrades. 
The medical center IT department can even create hospital-specific 
apps. 

Criteria for evaluating tablets 

Our first necessary criterion, cost, eliminated all the health-care-specific 
tablets from consideration, leaving us with only the general-purpose 
tablets. All the general-purpose tablets we evaluated met our HIPAA and 
ACA compliance and other security criteria. Unfortunately, because the 
general-purpose tablets are not designed for clinical settings, we could not 
determine from our research whether any of them are easy to disinfect. We 
would need to conduct our own tests to answer that question. 

We would need to conduct our own testing to determine whether 
battery life and durability of any of the general-purpose tablets are 
acceptable. 


The function of a conclusion is to 
explain what the data mean. Here 
the writers explain how their results 
can help their readers determine 
how to proceed with the tablet 
study. Notice that a conclusion is 
not the same as a recommendation 
(which explains what writers think 
should be done next). 

The writers present an advance 
organizer for the results section. 

At this point in the report, the 
writers have decided to abandon 
the "task" labels. Their thinking is 
that they are focusing less on what 
they did and more on the meaning 
of the information they gathered. 
However, they retain the headings 
that help readers understand the 
topic they are discussing. 
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Assessing available tablets based on our criteria 

We drew two main conclusions from our study of available tablets: 

• The best tablets for our use — the ones designed and intended for 
health-care settings — are out of our price range. Because they meet all 
our criteria, we should reassess whether our budget will permit us to 
assess them more carefully. 

• Any one of the available general-purpose tablets is potentially 
acceptable (provided it meets the disinfection criterion). We see no 
compelling reason to favor one operating system over another. Apple 
iPads, Android tablets, and Windows tablets all come with acceptable 
power, and there are plenty of health-care apps available for each type. 

As Android machines establish their dominance over the iPad, health- 
care apps for Android devices will surpass those for the iPad in variety 
and number. 
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We recommend that the RRMC administration pursue one of two options: 


Option 1: Reconsider the cost criterion 

Although a health-care-specific tablet, at $2,500-3,000, is some three 
times the cost of a general-purpose tablet, it offers distinct advantages 
in terms of disinfection properties, ruggedness, and availability of 
specialized hardware and software for better integration with our other 
devices and equipment. 

If it is not possible to provide health-care-specific tablets to all clinical 
staff, we might consider a two-tiered system (some staff members receive 
a health-care-specific tablet, others a general-purpose one) or a phased- 
implementation system. 


Option 2: Test a representative sample of general-purpose tablets • 

If RRMC wishes to continue to assess the general-purpose tablets, we 
recommend that we contact manufacturers of the Apple iPad, the 
Samsung Galaxy, the Microsoft Surface, and several other Android 
tablets. We could request that they supply their most powerful products, 
equipped with the best set of medical apps, for our internal testing and 
evaluation. 

We would then have IT test each tablet in a controlled environment for 
such technical characteristics as battery life and durability. We would also 
test each tablet for disinfection. Next, we would invite the manufacturers' 
representatives to attend a one- or two-day tablet fair, where we would 
make the products available to our clinical staff for demos and hands- 
on assessment. On the basis of these tests and follow-up questionnaires 
submitted by clinical staff, we would be in a good position to know how 
to proceed. 


This recommendation states 
explicitly what the writers think the 
reader should do next. Note that 
they are sketching in ideas that they 
have not discussed in detail but that 
might interest their readers. 
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Appendix: Clinical-Staff Questionnaire 

This is the questionnaire we distributed to the 147 RRMC clinical staff 
members. We received 96 responses. The numbers in boldface below 
represent the percentage of respondents who chose each response. 


19 


Questionnaire on Tablet Use at RRMC 

Directions: As you may know, Dr. Bremerton is conducting a study to determine 
whether to institute a formal policy on tablet use by clinical staff. 

If you own a tablet device, please respond to the following four questions. Your 
opinions can help us decide whether and how to develop a policy for tablet use at 
RRMC. We greatly appreciate your answering the following four questions. 

1 . Which brand of tablet do you own? 

47% Apple iPad 

28% Samsung Galaxy 
9% Amazon Kindle Fire 
6% Microsoft Surface 

1 0% Other (please name the brand) (Respondents named the Asus, Google 
Nexus, and a Toshiba model.) 

2. "I consider myself an expert user of my tablet." 

Strongly disagree 8% 2% 13% 19% 58% Strongly agree 

3. Do you currently use your tablet for a clinical application, such as monitoring 
patients or ordering procedures? 

63% Yes 
37% No 

4. If RRMC were to adopt a policy of using tablets for clinical applications (and to 
supply the appropriate software and training), which response best describes 
your attitude? 

27% I would prefer to use my own tablet. 

38% I would prefer to use a hospital-supplied tablet. 

35% I don't have strong feelings either way about using my own or a hospital- 
supplied tablet. 

0% I would prefer not to use any tablet at all for clinical applications. 

Thank you! 


Presenting the percentage data in 
boldface after each question is a 
clear way to communicate how the 
respondents replied. Although most 
readers will not be interested in the 
raw data, some will. 
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WRITER'S CHECKLIST 


In planning your recommendation report, did you 

I i analyze your audience? (p. 470) 

[ determine your purpose? (p. 470) 

EE identify the questions that need to be answered? 

(p. 471) 

□ carry out appropriate research? (p. 473) 

I draw valid conclusions about the results (if appropriate)? 

(p. 474) 

EH formulate recommendations based on the conclusions 
(if appropriate)? (p. 474) 

Does the transmittal letter 

EE clearly state the title and, if necessary, the subject and 
purpose of the report? (p. 479) 

EE clearly state who authorized or commissioned the 
report? (p. 479) 

I ! acknowledge any assistance you received? (p. 479) 

EH establish a courteous and professional tone? (p. 479) 

Does the cover include 
I the title of the report? (p. 479) 

□ your name and position? (p. 479) 

I ] the date of submission? (p. 479) 

I ] the company name or logo? (p. 479) 

Does the title page 

EE include a title that clearly states the subject and purpose 
of the report? (p. 479) 

EE list your name and position and those of your principal 
reader(s)? (p. 479) 

EE include the date of submission of the report and any 
other identifying information? (p. 479) 

Does the abstract 

EE list the report title, your name, and any other identifying 
information? (p. 479) 

EE clearly define the problem or opportunity that led to the 
project? (p. 479) 

EE briefly describe (if appropriate) the research methods? 
fp. 479) 

□ summarize the major results, conclusions, and 
recommendations? (p. 480) 


Does the table of contents 

□ contain a sufficiently detailed breakdown of the major 
sections of the body of the report? (p. 481) 

I I reproduce the headings as they appear in your report? 

(P-481) 

EE include page numbers? (p. 481) 

EE Does the list of illustrations (or list of tables or list of 
figures) include all the graphics found in the body of the 
report? (p. 481) 

Does the executive summary 

EE clearly state the problem or opportunity that led to the 
project? (p. 483) 

EE explain the major results, conclusions, recommenda- 
tions, and managerial implications of your report? 

(P- 483) 

EE avoid technical vocabulary and concepts that a 

managerial audience is not likely to be interested in? 

(P- 483) 

Does the introduction 

EE explain the subject of the report? (p. 476) 

EE explain the purpose of the report? (p. 477) 

EE explain the background of the report? (p. 477) 

EE describe your sources of information? (p. 477) 

I indicate the scope of the report? (p. 477) 

EE briefly summarize the most significant findings of the 
project? (p. 477) 

EE briefly summarize your recommendations? (p. 477) 

EE explain the organization of the report? (p. 477) 

EE define key terms used in the report? (p. 477) 

Does the methods section 

EE describe your methods in sufficient detail? (p. 477) 

EE justify your methods where necessary, explaining, for 

instance, why you chose one method over another? (p. 477) 

Are the results presented 

□ clearly? (p. 477) 

EE objectively? (p. 477) 

I without interpretation? (p. 477) 
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Are the conclusions 

IDD presented clearly? (p. 478) 

i_l drawn logically from the results? (p. 478) 

Are the recommendations 

□ clear? (p. 478) 

□ objective? (p. 478) 

CD stated politely? (p. 478) 

□ in an appropriate form (list or paragraph)? (p. 478) 

□ in an appropriate location? (p. 478) 


CD Does the glossary include definitions of all the technical 
terms your readers might not know? (p. 484) 

CD Does the list of symbols include all the symbols and 
abbreviations your readers might not know? (p. 484) 

CD Does the list of references include all your sources and 
adhere to an appropriate documentation system? 

(p. 486) 

CD Do the appendixes include supporting materials that 
are too bulky to present in the report body or that are of 
interest to only a small number of your readers? (p. 487) 


EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . An important element in carrying out a feasibility 
study is determining the criteria by which to judge 
each option. For each of the following topics, list five 
necessary criteria and five desirable criteria you might 
apply in assessing the options. 

a. buying a smartphone 

b. selecting a major 

c. choosing a company to work for 

d. buying a car 

e. choosing a place to live while you attend college 

2. Go to www.usa.gov and select the "Government 
Agencies" tab. Choose an agency and navigate to 
its website. Then find a recommendation report 
on a subject that interests you. In what ways does 
the structure of the report differ from the structure 
described in this chapter? In other words, does the 
report lack some of the elements described in this 
chapter, or does it have additional elements? Are 
the elements arranged in the order in which they 
are described in this chapter? In what ways do the 
differences reflect the audience, purpose, and subject 
of the report? 


3. TEAM EXERCISE Write the recommendation report 
for the research project you proposed in response to 
Exercise 3 on page 443 in Chapter 1 6. Your instructor 
will tell you whether the report is to be written 
individually or collaboratively, but either way, work 
closely with a partner to review and revise your report. 
A partner can be very helpful during the planning 
phase, too, as you choose a topic, refine it, and plan 
your research. 

4. Secure a recommendation report for a project 
subsidized by a city or federal agency, a private 
organization, or a university committee or task force. 
(Be sure to check your university's website; universities 
routinely publish strategic planning reports and other 
sorts of self-study reports. Also check www.nas.edu, 
which is the site for the National Academy of Sciences, 
the National Academy of Engineering, the Institute 

of Medicine, and the National Research Council, all of 
which publish reports on the web.) In a memo to your 
instructor, analyze the report. Overall, how effective is 
the report? Flow could the writers have improved the 
report? If possible, submit a copy of the report along 
with your memo. 
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CASE 18: Analyzing Decision Matrices 



As president of a music-instruction company, you are exploring the possibility of 
purchasing an electric guitar that can be used for digital recording. You ask your director 
of guitar instruction to investigate options for you, but you find some problems with 
her methodology. To get started helping her research the matter more successfully and 
provide helpful recommendations, go to "Cases" under "Additional Resources" in Ch. 18: 
macmillanhighered.com/launchpad/techcomm1 1 e. 






Writing Lab Reports 


Persuasion and Lab Reports 516 

Understanding the Process of Writing Lab Reports 577 
Understanding the Structure of the Lab Report 517 

TITLE 518 
ABSTRACT 518 
INTRODUCTION 518 

■ GUIDELINES: Writing Equations 519 
MATERIALS AND METHODS 520 
RESULTS 520 

• ETHICS NOTE: Presenting Data Honestly 521 

DISCUSSION 522 
CONCLUSION 522 
ACKNOWLEDGMENTS 522 
REFERENCES 523 
APPENDIXES 523 

Understanding the Role of Science and Engineering Articles 523 

• DOCUMENT ANALYSIS ACTIVITY: Evaluating Lab Reports 524 

Sample Lab Report 527 


WRITER'S CHECKLIST 531 
EXERCISES 532 

CASE 1 9: Introducing the Scientific Method Through a Lab Report 532 and 


516 


19 


WRITING LAB REPORTS 


RESEARCH CAN TAKE PLACE in a lab or at a field site. Lab reports play an 
important role in the process of understanding a scientific problem and solving it 
in the real world. 

Because communicating ideas in writing is central to the process of creating and 
publicizing knowledge, scientists and engineers spend a significant portion of their 
professional lives writing. Lab reports are one important way they communicate 
the results of their work. Adding new knowledge to a field is the collective effort of 
many people, each contributing information and ideas and building on the work of 
others. Although scientists and engineers might work alone or in small groups in a 
lab, if they want to contribute to their fields, they must convince readers that their 
findings are valid. For this reason, the ability to write clearly and persuasively is both 
necessary and valued in the sciences and engineering. 

Persuasion and Lab Reports 

Early in your science or engineering course work, you will likely be required 
to write lab reports presenting routine findings. That is, you will be asked to 
replicate studies and test hypotheses that have already been replicated and 
tested. The reason your instructor asks you to do such labs is to introduce 
you to the scientific method and teach you important lab skills you will need 
later when you do conduct original research. 

Your written lab report is the primary evidence on which your audience 
will judge your credibility and skills as a researcher. If your writing is poor, 
your readers might conclude that you are also a sloppy researcher. And if you 
fail to convince your audience that your work is professional and valuable, 
you might lose funding to continue. 

At first glance, a lab report might appear to be an unadorned presenta- 
tion of methods, data, and formulas. It isn’t. It is a carefully crafted argument 
meant to persuade an audience to accept your findings and conclusions. You 
need to justify virtually everything you did in the lab or in the field. To be 
persuasive, you need to answer these six questions: 

• Why is this topic important? 

• What have others already learned about the subject? 

• What remains to be learned about the subject? 

• Why are you using this methodology, as opposed to other methodologies, 
in carrying out the work? 

• Why do you draw these inferences, as opposed to others, from the data 
you generated? 

• What should be done next? Why? 

These questions do not have only one correct answer. You have to make the 
case that you have done your work professionally and used good judgment 
at every point — from choosing what to read in preparation, to designing and 
conducting the research in the field or the lab, to writing the report. In other 
words, you have to be persuasive. In each section of your lab report, you must 
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persuade your readers that you are a competent researcher who is familiar 
with the subject area and that you are presenting important information. 

Because of the way people read lab reports, each section of the report must 
be persuasive. Although the report is organized as a single argument, most 
readers will not read it in a linear fashion, from start to finish. In fact, many 
readers will not read the whole report. They might begin with the title and 
abstract. If these two elements suggest that the report might be useful, they 
might skip to the end and read the conclusions. If the conclusions are persua- 
sive, they might next read your introduction. If your introduction makes it clear 
that you are familiar with the field and know what you are doing, readers might 
then read the other sections of your report. 

If English is not your first language, allow extra time to revise, edit, and proof- 
read your lab reports carefully. You might also consider asking a native speaker 
of English to review them and point out areas where you could be clearer. 

Understanding the Process of Writing Lab Reports 

Many scientists and engineers record their laboratory work in notebooks with 
numbered pages or use specialized software. These notebooks contain enough 
information for other researchers or colleagues to understand how the pro- 
cedures were conducted, why the procedures were conducted, and what the 
writer discovered. Your instructor might ask you to keep a lab notebook. 

Although lab notebooks can be useful in legal disputes over who was first 
to conduct an experiment or make a discovery, their main purpose is to serve 
as researchers’ personal records. When researchers are ready to communi- 
cate their findings by writing their lab reports, they turn to their notebooks. 

If you understand what information goes where in a lab report, you can plan 
ahead during your research. 

The sections of a lab report do not need to be written in sequence. Some 
sections can be written early in the process; other sections must wait until 
you have finished your analysis of data. For example, although the title and 
abstract are often the first items to be read, they are usually the last items to 
be written. Likewise, it’s easier to write your introduction after you have writ- 
ten your methods, results, and discussion. Only then will you have a clear 
idea of how you wish to introduce your argument. 

Understanding the Structure of the Lab Report 

Most lab reports have eight basic elements: title, abstract, introduction, 
materials and methods, results, discussion, conclusion, and references. Some 
lab reports have additional elements, such as acknowledgments and appen- 
dixes. Although each researcher or instructor might prefer a slightly differ- 
ent format and style for organizing and presenting information, most lab 
reports follow a common structure reflecting the scientific method valued by 
scientists and engineers for centuries. This structure is typically used in lab 
reports that describe attempts to test a hypothesis or answer a question. It 
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For more about informative and 
descriptive abstracts, see Ch. 18, 
p. 479. 


might also be used in lab reports that merely describe following a procedure 
and report the results of that procedure. 

If you are a student, be sure to follow your instructor’s guidelines for the 
structure of your report. For example, some instructors prefer that you combine 
the results and discussion sections. For studies involving multiple procedures 
and generating large amounts of data, your instructor might prefer that you 
present one set of data and analyze it before you introduce the next set of data. 

The following discussion focuses on writing lab reports for undergraduate 
science and engineering courses. 

TITLE 

The title should be informative enough to enable readers to decide whether 
the report interests them. An informative title helps scientists and engineers 
save time by using abstracting and indexing services to locate the research 
most relevant for their needs. 

Write your title with your readers in mind. Use only words and abbrevia- 
tions that are familiar to them. The keywords in your title should be the terms 
commonly used by readers searching for information in your subject area. 
Keep in mind that because effective titles are specific, they tend to be long. 

weak Babbler Behavior 

improved Endocrine Correlates of Social and Reproductive Behaviors in a Group- 
Living Australian Passerine, the White-Browed Babbler 

weak New Technologies for Power Plants 

improved Evaluating New Instrumentation and Control Technologies for Safety- 
Related Applications in Nuclear Power Plants 


ABSTRACT 

The abstract summarizes the entire report, mirroring its structure: introduc- 
tion, methods, results, discussion, and conclusion. However, because of space 
limitations, each section is addressed in only a sentence or two. Because your 
abstract might be distributed more widely than your entire report, it should 
contain enough information so that your readers can quickly decide whether 
to locate and read the whole report. Readers of abstracts are most interested 
in what questions motivated your study (introduction), what answers you 
discovered (results), and what implications your findings have (conclusions). 
A well-written abstract can also meet readers’ need to stay up to date on 
research findings without spending a lot of time doing so. 

Most readers prefer informative abstracts, which present the major find- 
ings. Less popular is the descriptive abstract, a shorter form that simply states 
the topics covered in the report without presenting the important results or 
conclusions. 

INTRODUCTION 

The introduction is the section of the report in which you begin to estab- 
lish that your work is important. Here, you place your work in the broader 
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context of your field by describing the hypothesis or question your study 
attempted to address and why this question is significant. The introduction 
should include a concise review of previous research relevant to your study 
and should describe how your study extends the knowledge in your field or 
overcomes a weakness in previous studies. By placing your study in the con- 
text of previous research, you establish its significance. Provide just enough 
detail to help readers understand how your study contributes new informa- 
tion to the field and to communicate the purpose of your study. 

If you think readers will need specialized knowledge or theoretical back- 
ground to understand your study, define important terms and present theoreti- 
cal concepts in this section. Use your understanding of your audience to help 
you determine how much theoretical background to include. Often, instructors 
will ask you to write for an audience of classmates who are familiar with the 
general subject area but not familiar with the specific lab work you are reporting. 

Your introduction should also briefly describe your methods: what you did 
to find an answer to your research question. Although your methods sec- 
tion provides a detailed account of your approach, your introduction should 
persuade your readers that your methods are appropriate given what has been 
done in previous studies. 

If you include equations in the introduction, adhere to the conventions 
presented in the Guidelines box. 


A 


GUIDELINES 


Writing Equations 


When you write equations, follow these four suggestions. 


► Use an equation editor, or write equations by hand. Some word processors 
include equation editors that allow you to insert mathematical symbols, Greek 
letters, integrals, and fractions. Unless your word processor includes an equation 
editor or you have access to a commercially available equation editor, do not try 
to approximate an equation with standard text and punctuation. Many instruc- 
tors allow students to handwrite equations on lab reports after they have been 
printed. Check with your instructor. 

► Place each equation on a separate line. Because equations often involve charac- 
ters positioned above or below the main line of type as well as odd-shaped sym- 
bols, equations written in the body of your text can create awkward line spacing, 
making your text difficult to read. Start each equation on a new line, with extra 
white space surrounding the equation. 

► Number each equation. Number equations consecutively throughout your 
report, beginning with equation 1 . Refer to the equation by number in your text: 
"The line represents the theoretical curve based on equation 1 

► If appropriate, omit basic equations. If your instructor's guidelines permit it, omit 
equations with which your readers are familiar, especially in advanced lab reports. 
Starting at too basic a level will make your report too long and will interrupt your 
readers'train of thought. 


For more about definitions, see 
Ch. 20, p. 535. 
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For more about active and passive 
voice, see Ch. 10, p. 231. 


MATERIALS AND METHODS 

Your purpose in writing the materials and methods section (sometimes 
called equipment and methods ) is to convince your readers that your approach 
was appropriate for the question you hoped to answer, that you conducted 
your research or experiment carefully, and that your results are credible. 
Describe your methods in enough detail that another researcher could 
perform the same experiment using the same materials and methods. This 
characteristic, called replicability, is one of the foundations of the scientific 
method. 

Most researchers begin the materials and methods section with a descrip- 
tion or list of materials. Include any human subjects, organisms, chemicals, 
tools, and measuring devices used. Your description of materials might also 
include sketches, diagrams, schematics, or photographs of equipment, as 
well as explanations of how you set it up. 

Next, describe your procedures. Include relevant conditions such as tem- 
peratures, observation dates and times, instrument settings and calibration, 
and site locations for field studies. Also indicate whether you encountered 
any difficulties with standard procedures and, if so, how you modified your 
approach to address those difficulties. Finally, if you had to make subjective 
decisions in collecting data, explain your choices. Although your audience 
might want to repeat your experiment, some instructors prefer that you 
avoid numbered, step-by-step instructions, presenting instead an organized 
description of what you did in sufficient detail that readers can understand 
your process. Organize this section chronologically, in the order in which you 
conducted your research or experiment. Include only those procedures that 
led to results that you present in the report. 

When providing details, assume your readers are unfamiliar with the 
particulars of your experiment but know enough about lab procedures to 
evaluate your efforts. Your credibility rests on your ability to explain clearly 
what you did and why. 

Although writing in the active voice (“I collected three soil samples”) is 
generally more concise, clearer, and more interesting than writing in the 
passive voice (“Three soil samples were collected”), the sciences and engi- 
neering have a long tradition of using the passive voice. The passive voice 
emphasizes the material studied and the actions taken, deemphasizing the 
role of the researcher. However, more and more scientific and engineering 
publications are accepting use of the active voice. Check with your instructor 
to learn which style he or she prefers. 

RESULTS 

Think of the results section as an opportunity to present the evidence you will 
use to support the claims you will make in your discussion. How persuasive 
this evidence is depends on how successfully you present it to your readers. 

Your research will likely produce raw data in the form of numbers. In the 
results section, your task is to summarize the data relevant to the question 
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or hypothesis you discussed in your introduction. Omit irrelevant data, but 
explain why you are doing so. When summarizing your data, help readers 
understand your findings by emphasizing major trends, magnitudes of val- 
ues, associations, patterns of statistical significance, and exceptions. Typi- 
cally, you present results in the same order used in describing the steps in 
the methods section, but you can change the order if you have a good reason 
to do so. For instance, you might use the more-important-to-less-important 
organizational pattern by beginning with the set of data that most clearly 
supports or negates your hypothesis. 

Be sure your data are complete and organized. For each major trend or 
pattern, begin with a statement of your findings and then support your 
statement with data. Depending on the type of data, you might present your 
supporting evidence with a combination of text and graphics (such as tables, 
graphs, and diagrams). If you include graphics, refer to them in the text with 
a statement explaining their significance. 

weak Results of bacteria sampling are shown in Table 1 . 

improved As Table 1 shows, the rate of bacteria growth increased as groundwater 

temperature increased. 

In the results section, do not interpret or explain your data and do not 
speculate about problematic or atypical data. Save those explanations for the 
next section, the discussion. 


For more about organizational 
patterns, see Ch. 7, p. 149. 


For more about explaining the 
significance of graphics, see Ch. 12, 
p. 295. 


ETHICS NOTE 


PRESENTING DATA HONESTLY 

The hallmark of good science is the honest and complete presentation of results, even if some 
of those results undercut the hypothesis. It is unethical to omit from your results section data 
that do not support your hypothesis. For instance, your hypothesis might be that as tempera- 
ture increases, the growth rate of the organism you are studying increases. However, some 
of your data show that, above a certain temperature, the growth rate remains steady. You 
have replicated the procedure several times and gotten the same results, but you can't explain 
them. What do you do? You present the data and offer your best explanation, but you also 
state clearly that you can't fully explain the data. In other words, you tell the truth. 

Likewise, it is unethical to choose a type of graphic that obscures negative findings or to de- 
sign a graphic so that data points are omitted. For example, if you used a spreadsheet to re- 
cord your data about temperature and growth rate, in order to present these data in a graphic, 
such as a line graph, you must select the cells you want to be represented in the graph. It 
would be easy to omit cells that included negative or inexplicable findings. However, doing 
so would be dishonest and therefore unethical — an obvious violation of scientific norms. In- 
consistent data or contradictory results often lead researchers to examine their approach and 
assumptions more carefully, which can lead to breakthroughs in a field of study. 

Remember that inconsistent data or contradictory results do not necessarily mean that you 
performed the research or experiment unprofessionally.They simply mean that reality is com- 
plicated. Readers will accept that. What they won't accept is a misleading or dishonest lab 
report. 
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DISCUSSION 

Sometimes called analysis, the discussion section is where you interpret your 
results: that is, you answer the question or support (or argue against) the 
hypothesis you discussed in your introduction. 

In organizing the discussion section, start by presenting the most impor- 
tant findings, which might include major trends, magnitudes of values, 
associations, patterns of statistical significance, and exceptions. Focus on 
offering explanations for your findings. Support your argument with data 
from your results, and do not hesitate to discuss problematic data or “failed” 
experiments. Remember that sometimes a negative result or a failure to 
find a significant difference helps researchers create new knowledge in their 
field. If your results do not support your hypothesis, argue for rejecting your 
hypothesis. If appropriate, support your argument with references to the 
work of other researchers, describing the degree to which your results match 
the results of previous studies. If your findings do not match the results of 
previous studies, suggest possible explanations for the differences. 

CONCLUSION 

Summarize the main points covered by your report in one or two concise 
paragraphs. Begin by reviewing the purpose of your research or experiment 
and the hypothesis (or hypotheses) you tested. Next, summarize the most 
important implications of your findings. The conclusion is your final oppor- 
tunity to persuade your audience of the significance of your work. Do not 
introduce any new information or analysis in this section. 
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Use we if the report was written by 
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section. Typically, scientists and engineers ask permission of the people they 
wish to thank before including them in the acknowledgments. 

REFERENCES 

List all the references you cited in your lab report. (Do not list any sources 
that you consulted but did not cite.) Most of your citations will appear 
in the introduction, materials and methods, and discussion sections. 
However, check the other sections as well to make sure you include all 
sources cited in your report. Most scientists and engineers follow a par- 
ticular documentation system for their discipline (see Appendix, Part B, 
page 614). Check your instructor’s preferences before selecting a docu- 
mentation system. 

APPENDIXES 

An appendix, which follows the references, is the appropriate place for infor- 
mation that readers do not need to understand the body of your lab report. 
For example, an appendix might include long tables of measurements, spe- 
cialized data, logs, analyses, or calculations. 

By following the basic structure of a lab report discussed here, you will 
help your readers manage the large quantities of information produced in 
science and engineering. The title and abstract will help readers quickly 
decide if a report is relevant. The introduction and conclusion will provide 
the context for the study and describe the most important results of the 
study. If readers are persuaded to read further, the methods, results, and dis- 
cussion will provide the detailed information they seek. 


Understanding the Role of Science and 
Engineering Articles 

If you are a science or engineering student, you will have many opportuni- 
ties to write about your field once you enter the working world. Rather than 
writing for an audience of teachers, you will write for a professional audience 
of supervisors, members of professional boards, government officials, clients, 
other scientists or engineers, and potential funding sources. Your reports 
might be read only by people in your organization, or you might have a global 
audience. 

Both researchers and practitioners sometimes develop their lab reports 
into articles for publication in professional journals. Some companies offer a 
monetary bonus to employees who publish articles in scholarly journals. These 
articles help the companies gain recognition as leaders in innovation and help 
the researchers demonstrate their ability to contribute new ideas to the field. 
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DOCUMENT ANALYSIS ACTIVITY 


Evaluating Lab Reports 


The grading sheet included 
here is used by an engineering 
professor to evaluate the lab 
reports written by students in 
his Principles of Environmental 
Engineering lab course. One of 
the labs in that course requires 
students to evaluate the 
efficiencies of several waste- 
water-treatment strategies and 
then determine whether the 
strategies can meet or exceed 
proposed discharge-effluent 
limits. The questions on the 
next page ask you to consider 
the grading sheet based on 
the discussion of lab reports in 
this chapter. 


SOLIDS REPORT GRADING SHEET 


Total: /1 00 

Student Names: 

Points 

Earned 

Points 

Possible 

Report Section 


2 

Cover (1 ) and title page (1 ) 


10 

Abstract, including the following: 



Problem statement (3) 



Methods used (2) 



Results (2) 



Conclusions/Recommendations (3) 


6 

Indexes (generated by the software), including the 
following: 



Table of Contents (2) 



List of Figures (2) 



List of Tables (2) 


12 

Summary includes the following: 



Evaluation of results (6) 



Answers to questions that management would 
be concerned with (6) 


10 

Introduction includes the following: 



Background information (2) 



Problem/purpose statement (2) 



Plan/procedures for testing; outline for selection/ 
solution (2) 



Description of rest of report (2) 



Definition of terms/limitations/assumptions (2) 


5 

Procedures correctly name the tests and reference 
the procedures. 


10 

Results summarize final results in paragraph form 
and include tables or graphs as appropriate. Results 
reference raw data and all example calculations. 


10 

Discussion correctly interprets results and discusses 
their meanings; correctly discusses acceptable/ 
typical/reasonable ranges and explains unexpected 
results. 


( continued ) 
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Evaluating Lab Reports ( continued ) 


Total: /1 00 

Student Names: 

Points 

Earned 

Points 

Possible 

Report Section 


5 

References (complete and correctly using CSE style) 


10 

Appendixes 


10 

Sample calculations presented accurately (5 each) 


10 

Writing skill and format: 



Correct spelling and grammar (4) 



Consistency of headings, capitalization, bolding, 
italicization, table and graph appearance, etc. (2) 



Correct numbering and titling of tables (2) 



Correct numbering, titling, and design of graphs 
(axes labeled correctly, clear legends) (2) 


100 

TOTAL POINTS 


1 . In what ways does this 
grading sheet follow the 
basic format of a lab report 
discussed in this chapter? In 
what ways does it not follow 
the basic format? 

2 . Do you agree or disagree 
with the relative importance 
placed on report elements 
in this grading sheet? How 
would you change the 
allotting of points? 

3 . If the instructor distributed 
this grading sheet at the 
start of a lab assignment, 
how might students in the 
lab use it to help them write 
their lab reports? 
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Articles in the sciences and engineering are often organized like lab 
reports. However, rather than following an instructor’s preferences, research- 
ers in the workplace follow the author guidelines of the journal to which they 
will submit their article. Figure 19.2 shows one organization’s author guide- 
lines for preparing a manuscript. 


This page provides prospective 
authors with information on how 
to prepare a manuscript for submis- 
sion to IEEE journals. IEEE (which 
originally stood for Institute of Elec- 
trical and Electronics Engineers, Inc.) 
is the world's leading professional 
association for the advancement of 
technology. With 425,000 members 
(including 116,000 student mem- 
bers), IEEE publishes almost 1 50 
journals and magazines. 


Instructions explain how to number 
manuscript pages and graphics, 
how to format papers, what to 
include in an abstract, and how to 
document references. 


IEEE publications require a unique 
documentation style and format. 
Sample formats for common types 
of references in this field are shown. 


The more closely an article follows 
a journal's author guidelines, the 
more likely it is to be accepted for 
publication and the more quickly it 
will be available to readers. 


in the subjects being treated. The papers are of long-range 
interest and broad significance. Applications and 
technological issues, as well as theory, are emphasized. The 
topics include all aspects of electrical and computer 
engineering and science. From time to time, papers on 
managerial, historical, economic, and ethical aspects of 
technology are published. Papers are authored by recognized 
authorities and reviewed by experts. They include extensive 
introductions written at a level suitable for the nonspecialist, 
with ample references for those who wish to probe further. 
Several issues a year are devoted to a single subject of 
special importance. 

Prospective authors, before preparing a full-length manu- 
script, are urged to submit a proposal containing a description 
of the topic and its importance to Proceedings readers, 
a detailed outline of the proposed paper and its type of 
coverage, and a brief biography showing the authors’ 
qualifications for writing the paper. A proposal can be 
reviewed most efficiently if it is sent electronically to the 
Managing Editor at j.calder@ieee.org. If the proposal 
receives a favorable review, the author will be 
encouraged to prepare the paper for publication 
consideration through the normal review process. 


Proceedings of the IEEE 
445 Hoes Lane 
P.O. Box 1331 

Piscataway, NJ 08855-1331 USA 
Fax: +1 732 562 5456 



All manuscript pages, footnotes, equations, and references 
should be labeled in' consecutive numerical order. Illustrations 
and tables should be cited in text in numerical order. See 
Section iy^o of this guide. 

kmuscript Formats 

See copies of the publications for examples of proper paper 
formats and requirements for the types of papers accepted for 
each publication (i.e.. Full Papers, Letters, Short Papers, etc.). 

Full length papers generally consist of the title, byline, 
author affiliation, footnote (including any financial support ac- 
knowledgment), index terms, abstract, nomenclature if present, 
introduction, body, conclusions, reference list, list of figures 
and table captions, and original figures and tables for repro- 
duction. A paper may also include appendixes, a glossary of 
symbols, and an acknowledgment of nonfinancial support. 

C. Abstract 

The abstract should be limited to 50-200 words and should 
concisely state what was done, how it was done, principal 
results, and their significance. The abstract will appear later in 
various abstracts journals and should contain the most critical 
information of the paper. 


D. References 

A numbered list of references must be provided at the end of 
the paper. The list should be arranged in the order of citation in 
text, not in alphabetical order. List only one reference per 
reference number. 

In text, each reference number should be enclosed by square 
brackets. Citations of references may be given simply as “in [ 1 ] 
...”, rather than as “in reference [1] ...”. Similarly, it is 
not necessary to mention the authors of a reference unless the 
mention is relevant to the text. It is almost never useful to give 
dates of references in text. These will usually be deleted by 
Staff Editors if included. 

Footnotes or other words and phrases that are not part of the 
reference format do not belong on the reference list. Phrases 
such as “For example,” should not introduce references in the 
list, but should instead be given in parentheses in text, followed 
by the reference number, i.e., “For example, see [5].” 

Sample correct formats for various types of references are 
as follows. 

Books: 

[1] G. O. Young, “Synthetic structure of industrial plastics,” in 
Plastics, 2nd ed., vol. 3, J. Peters, Ed. New York: 
McGraw-Hill, 1964, pp. 15-64. 

[2] W.-K. Chen, Linear Networks and Systems. Belmont, 
CA: Wadsworth, 1993, pp. 123-135. 

Periodicals: 

[3] J. U. Duncombe, “Infrared navigation — Part I: An assess- 
ment of feasibility,” IEEE Trans. Electron Devices, vol. 
ED-11, pp. 34-39, Jan. 1959. 

[4] E. P. Wigner, “Theory of traveling-wave optical laser,” 
Phys. Rev., vol. 134, pp. A635-A646, Dec. 1965. 

[5] E. H. Miller, “A note on reflector arrays,” IEEE Trans. 
Antennas Propagat., to be published. 

Articles from Conference Proceedings (published): 

[6] D. B. Payne and J. R. Stem, “Wavelength-switched pas- 
sively coupled single-mode optical network,” in Proc. 
IOOC-ECOC, 1985, pp. 585-590. 

Papers Presented at Conferences (unpublished): 

[7] D. Ebehard and E. Voges, “Digital single sideband detec- 
tion for interferometric sensors,” presented at the 2nd Int. 
Conf. Optical Fiber Sensors, Stuttgart, Germany, Jan. 2-5, 
1984. 

Standards/Patents: 

[8] G. Brandli and M. Dick, “Alternating current fed power 
supply,” U.S. Patent 4 084 217, Nov. 4, 1978. 

Technical Reports: 

[9] E. E. Reber, R. L. Mitchell, and C. J. Carter, “Oxygen 
absorption in the Earth’s atmosphere,” Aerospace Corp., 

Los Angeles, CA, Tech. Rep. TR-0200 (4230-46)-3, Nov. 
1968. 


FIGURE 19.2 Excerpt from IEEE Author Guidelines 

Source: From IEEE, "Information for IEEE Transactions, Journals, and Letters Authors," p. 4. Copyright © 2010 IEEE. Reprinted by 
permission. 
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When a scientist or engineer submits an article for publication, the argu- 
ment and its supporting evidence are carefully evaluated by other profes- 
sionals in the field. This type of evaluation is called peer review. Peer review- 
ers make suggestions for revision and, ultimately, recommend whether the 
editor of the journal should accept the article for publication. The review 
process can involve extensive revisions, multiple drafts, and even disagree- 
ments. When the peer reviewers agree that an article represents a persua- 
sive scientific argument and offers significant new insights, the article is 
ready for copyediting and eventual publication in the journal. The entire 
process, from initial submission to publication, can last several months to 
well over a year. 

An increasing number of journals now allow prepublication. That is, they 
permit an author to post a draft of an article either on the journal’s own web- 
site or on some other site, enabling other researchers to read the draft and 
offer comments or suggest revisions. Then, the author can revise the article 
and submit it for publication by the journal. This practice is meant to take 
advantage of the expertise of a broad community of readers while maintain- 
ing the rigor of refereed publication. 


Sample Lab Report 

The following lab report (adapted from Thomford, 2008) was written for an 
undergraduate human-physiology lab experiment. 


BILE SALTS ENHANCE LIPASE DIGESTION OF FATS 
Abstract 

Bile salts, which are secreted by the gall bladder into the small intestine, play 
an important role in the digestion of dietary fats by pancreatic lipase. The 
digestion of milk fat by pancreatic lipase in the presence and absence of bile 
salts was tested to demonstrate whether bile salts help pancreatic lipase digest 
fat more efficiently. Based on pH measurements at four time intervals, the 
production of fatty acids occurred most quickly in the test group containing 
bile salts and pancreatic lipase. In the test group containing only bile salts, no 
fat digestion occurred. Bile salts enhanced the rate of lipase-fat digestion but 
did not digest fats alone. This lab shows that bile salts act only to emulsify fats, 
enabling pancreatic lipase to digest fats more efficiently. 



Keywords in the title reflect the 
major focus of the lab. 


The abstract concisely communi- 
cates the purpose of the lab, the 
approach, the results, and the 
significance of the findings. Some 
instructors require an abstract, and 
some do not. 
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Headings reflect common elements 

1 

in a lab report and help communi- 

— • Introduction 

cate the organization of the report. 



The pancreas secretes various enzymes into the small intestine. One of these 

— 

• enzymes, pancreatic lipase, digests dietary fats into products such as glycerol 

Because the discussion moves from 

and fatty acids (Mader, 2007). However, fat is insoluble in water-based chvme 

general to specific, readers are 

(the liquefied food processed by the stomach), and in the intestines the fats 

introduced to background concepts 

cling together, providing little surface area for attachment of the enzymes. This 

necessary to understand the rest of 

prolongs the time it takes the lipase to digest the fat. 

the report. 

In order to speed up the fat digestion process, bile salts, secreted by the gall 


bladder into the small intestine, act as a detergent that breaks up the fat 

Statements are supported by 

droplets in the watery chyme, thus increasing the surface area for enzymatic 

references to research relevant to 

• digestion by lipase (Martini & Timmons, 2005). In other words, bile is an 


emulsifying agent. Emulsification of fats is achieved upon exposure to 


bile salts, which allows pancreatic lipase to digest the fat more efficiently. 


To demonstrate that bile salts enhance the digestion of fats, the digestion 

The purpose of the lab is clearly 

of milk fat by pancreatic lipase in the presence and absence of bile salts was 

stated. 

tested. 




Methods are detailed enough 
so that another researcher could 
perform the same experiment using 
the same methods. 

Methods include relevant proce- 
dures, such as the type of pH paper 
used, incubation temperature, and 
testing intervals. Note that the 
entire materials and methods sec- 
tion is written in the past tense. 


Materials and Methods 

Three groups of test tubes were set up; three replicates were set up in each 
group in order to provide an adequate sample size. To each group of three test 
tubes, the following were added: 

Group 1: 3.0 ml of whole milk + 5.0 ml of water + 3 grains of bile salts 
Group 2: 3.0 ml of whole milk + 5.0 ml of pancreatin solution ( see below 
for concentration) 

Group 3: 3.0 ml of whole milk + 5.0 ml of pancreatin solution + 3 grains 
of bile salts 

Dehydrated pancreatin, derived from pig pancreas, was reconstituted in water 
(@ lg/lOOml) immediately before use. This solution contained the pancreatic 
lipase enzyme that was used to digest the milk fats. Dried grains of bile salts, 
derived from the pig gall bladder, were dissolved directly in each test tube. 

To determine the increase in fatty acid end-products during the digestion of 
fats, the pH of the incubated solutions (as fatty acid concentration increases, 
pH decreases) was tested. The pH of each test tube was determined at time zero 
(beginning of the experiment) using “short range” pH paper (reads pH 6-10). 
The test tubes were incubated at 37°C for 1 hour. During that hour, the pH was 
tested every 20 minutes. 
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Results 

The pH did not decrease during the 60-minute incubation period in the negative 
control group 1, which contained only milk and bile salts (Table 1). In groups 
2 and 3, the pH did decrease as the digestion of fats progressed, and fatty acids 
built up in the test tubes. After 20 minutes, the pH decreased in group 2 from 
8.5 to 7.5, while there was a greater change in tube 3 (from pH 8.5 to 7.0). At 40 
minutes incubation, the pH of the solutions in both groups 2 and 3 had dropped 
to 6.5 and did not decrease further at 60 minutes. 

Table 1. Mean* pH of whole milkduring incubation 
with bile salts and/or pancreatin 


Time 

Group 1 

Group 2 

Group 3 

(minutes) 

(+ B.S.') 

(+ pancreatin) 

(+ B.S. + pancreatin) 

0 

8.3 

8.5 

8.5 

20 

8.4 

7.5 

7.0 

40 

8.3 

6.5 

6.5 

60 

8.3 

6.5 

6.5 


*Mean pH of three sample tubes per group 
'Bile salts 


The data for all three groups are visually plotted in Figure 1. 


PH 


9 

8 

7 

6 

5 

4 

3 

2 

1 

0 



0 20 40 60 


Time (minutes) 


Bile Salts Only 
Pancreatin Only 
Pancreatin + B.S. 


Data are presented not only 
in a table but also in the text. 

Both the table and the figure are 
referred to in the text. Note that the 
results are not interpreted in this 
section of the lab report. 

Note that the entire results section 
is written in the past tense. 

The table and figure are labeled 
with informative titles. Each graphic 
clearly presents a manageable 
amount of information. 


Figure 1. Mean pH of whole milk during incubation 
with bile salts and/or pancreatin 
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The discussion explains the purpose 
of the lab: to demonstrate that bile 
salts enhance the digestion of fats. 


The discussion also explains why 
the experiment yielded the results 
that it did. Relevant research find- 
ings are referenced to support the 
writer's explanations. 


The final paragraph discusses the 
ambiguity of some of the results 
and suggests further experiments 
to address new questions raised by 
the current experiment. 


Discussion 

The negative control tube containing only bile salts and milk did not exhibit a 
pH change. Therefore, it was concluded that bile salts alone did not digest milk 
fats. Digestion of milk fats occurred in tubes 2 and 3, based on the observation 
of fatty acid by-product accumulation, as measured by a decrease in pH. 
However, the production of fatty acids occurred faster in group 3, as evidenced 
by the data at 20 minutes. This finding suggests that something present in the 
solution of group 3 aided in the digestion of the fats. Since the concentration of 
pancreatin was identical in groups 2 and 3, the addition of bile salts must have 
contributed to the digestion of the fats by breaking up those fat droplets into 
smaller particles, which increased the availability of substrate in group 3. The 
action of bile salts enhanced the rate of the lipase-fat digestion. The data from 
group 1, as a negative control, demonstrates that bile salts do not digest fats; 
therefore, bile salts must act only to emulsify the fats, thus enabling pancreatic 
lipase to act more efficiently. This conclusion is also supported by work done by 
Patton and Carey (1979) and reported by Bowen (2007). 

It was also determined that either the enzymatic activity of pancreatic lipase 
is inhibited below pH 6.5, or the fat substrates were depleted by 40 minutes 
in tubes 2 and 3, since there was no change in pH between 40 and 60 minutes. 
Further experimentation will reveal which of these two possibilities occurred. 
Fox (2008) reported that the optimal activity of pancreatic lipase occurs at a 
pH of 8. Therefore, it is most likely that the lack of change in pH between 40 
and 60 minutes in tubes 2 and 3 was due to the fact that the accumulation of 
fatty acid end-products produced an excessively acidic environment (pH 6.5 
at 40 minutes), thereby inhibiting further enzyme activity. This may suggest 
that pancreatic lipase is denatured in weakly acidic conditions between pH 
7.0 and 6.5. However, if this is not the case, an alternative conclusion may 
be that depletion of substrate occurred during the experimental period. This 
experiment should be re-run using cream or vegetable oil, both of which 
contain significantly more fat than whole milk. 



The references contain all the works 
cited in the body of the report. 
References are a mix of up-to-date 
sources and older but still relevant 
research. References follow Ameri- 
can Psychological Association (APA) 
format. 
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WRITER'S CHECKLIST 


Does the title 

' ' convey the major focus of your study? (p.518) 

□ use only words and abbreviations familiar to your 
readers? (p. 518) 

□ use keywords that readers would likely use to search for 
research in your subject area? (p.518) 

Does the abstract 

□ state the problem or question addressed by your study? 
(p.518) 

□ summarize your approach? (p. 518) 

□ summarize key results and conclusions? (p. 518) 

EE briefly discuss the implications of your study? (p. 518) 

I make sense to readers who have not read your entire 

report? (p.518) 

Does the introduction 

EE concisely review research relevant to your study? (p. 5 19) 
EE explain how your study contributes to the field? (p. 519) 

□ state the purpose of your study? (p.519) 

EE briefly describe your methods? (p.519) 

Does the materials and methods section 

EE describe the materials and equipment used (if 
appropriate)? (p. 520) 

I describe your procedures with enough detail for readers 

to understand what you did? (p. 520) 

EE address any problems encountered and describe your 
solutions? (p. 520) 

include a description and rationale for any subjective 
measurements? (p. 520) 

. present information in a logical order? (p. 520) 

Does the results section 

□ summarize all the data relevant to the question or 
hypothesis you discussed in your introduction? (p. 520) 

I exclude data not applicable to your argument? (p. 521) 

□ emphasize important trends and patterns? (p. 521) 

□ use text and graphics to present data concisely? (p. 521) 

I introduce and explain (if appropriate) each graphic in 

your text? (p.521) 


EH avoid interpreting, analyzing, and speculating about 
data? (p. 521) 

Does the discussion section 

I address the question or hypothesis discussed in your 

introduction? (p. 522) 

[ address the major trends, magnitudes of values, 

associations, patterns of statistical significance, and 
exceptions that emerged from your study? (p. 522) 

□ present plausible explanations for your results? (p. 522) 

EE support your argument with data from your results? 

(p.522) 

□ compare your work to and comment on relevant work of 
other researchers? (p. 522) 

□ comment on problematic or "negative" results (if 
appropriate)? (p. 522) 

Does the conclusion section 

EH briefly review the purpose of the research or 
experiment? (p. 522) 

□ summarize important implications of the findings? 

(p. 522) 

EE avoid introducing new information? (p. 522) 

Does the acknowledgments section 

EE thank the people who helped you conduct the lab or 
write the lab report? (p. 522) 

EE identify any sources of financial support for the study? 

(p. 522) 

EE identify only people and organizations that have 
specifically given permission to be listed? (p. 523) 

Does the references section 

EE identify each source cited in your lab report? (p. 523) 

□ contain complete and accurate information for each 
citation? (p. 523) 

EE follow your instructor's preferred format for references? 
(p. 523) 

EE Do the appendixes contain information not needed to 
understand the body of your report? (p. 523) 
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EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . Using a search engine, locate three or four sample lab 
reports. In a brief memo to your instructor, compare and 
contrast the basic elements of the reports. In what ways 
do they follow a similar format? If the reports differ in 
format, why do you think the authors chose to present 
information in the manner they did? 

2. Locate a word-processing program with an equation 
editor, or download a free equation editor from the 
Internet. Practice creating four to six equations you 
might use in your field. If you do not regularly use 
equations, copy a few equations from science or math 
textbooks. In a brief memo to your instructor, evaluate 
the equation editor's ease of use. 

3. Although you are likely to be unfamiliar with the subject 
of the following abstract (Agamy, 2013), the authors 
have made it possible for you to understand the logic of 
their article. In a brief memo to your instructor, identify 
the concept that the authors wished to study, the 
methods they used, their principal findings, and their 
recommendations. What techniques did the authors use 
to make it possible to understand their logic? (Sentence 
numbers have been added for convenience.) 

Sub chronic exposure to crude oil, dispersed oil and 
dispersant induces histopathological alterations 
in the gills of the juvenile rabbit fish (Siganus 
canaliculatus ) 

Abstract: (1) There is little existing information 
on the sub-lethal effects of experimental exposure 
of Arabian Gulf fish to oil pollution. (2) This study 
investigated the potential sub-lethal effects of the water 
accommodated fraction (WAF) of light Arabian crude 
oil, dispersed oil and dispersant (Maxi Clean 2) on the 


gills of the juvenile rabbitfish (Siganus canaliculatus), 
observing several histopathological biomarkers at 
different time points and different doses. (3) These 
laboratory exposures simulated a range of possible oil 
pollution events. (4) Significant alterations in four health 
categories (circulatory, proliferative, degenerative 
and inflammatory) were identified and form the basis 
for understanding the short-term response offish to 
oil. (5) Evaluations of histopathological lesions in gill 
tissue were carried out following 3, 6, 9, 12, 15, 18 and 
21 days of exposure. (6) The main lesions observed 
and quantified were lamellar capillary aneurysms, 
vasodilatation of lamellae, hemorrhage, edema, lifting 
of lamellar and filamentary epithelium and epithelium 
necrosis, epithelial and chloride cell hypertrophy and 
hyperplasia, fusion of adjacent lamellae, epitheliocystis 
and inflammatory infiltration. (7) Exposure of juvenile 
fish to WAF, dispersed oil and dispersant caused 
significant changes in the gill lesions and reaction 
patterns. (8) Dispersed oil caused the most significant 
effect followed by WAF and then dispersant. (9) The 
present study is one of the first which explores the 
relationship between oil pollution and epitheliocystis 
and reports that exposure to crude oil and dispersed oil 
increases the prevalence of epitheliocystis formation 
under controlled laboratory conditions. 

4. TEAM EXERCISE Form groups of students from 
different majors. Each group member should locate 
author guidelines for a journal in his or her field. Often, 
author guidelines can be found on the website of a 
journal or in the back of journal issues. As a group, 
compare the guidelines. How are the guidelines similar? 
How are they different? Present your results in a memo 
to your instructor. 


CASE 19: Introducing the Scientific Method Through a Lab Report 



You've been asked to assist a professor who is teaching an introductory-level anatomy 
and physiology course that includes a lab component. Because many students either 
have not prepared lab reports at all or prepared them much differently in high school, 
the professor finds it helpful to distribute a sample lab report. The sample, however, is not 
comprehensive, so you have been asked to create a handout explaining what this particular 
lab report does and doesn't do, with the main goal of helping students understand the 
objective of a lab report. To get started designing your handout, go to "Cases" under 
"Additional Resources" in Ch. 19: macmillanhighered.com/launchpad/techcomm11e. 







Writing Definitions, 
Descriptions, and 
Instructions 

Writing Definitions 535 

ANALYZING THE WRITING SITUATION FOR DEFINITIONS 535 
DETERMINING THE KIND OF DEFINITION TO WRITE 536 

a GUIDELINES: Writing Effective Sentence Definitions 537 

DECIDING WHERETO PLACETHE DEFINITION 541 

Writing Descriptions 543 

ANALYZING THE WRITING SITUATION FOR DESCRIPTIONS 543 
INDICATING CLEARLYTHE NATURE AND SCOPE OF THE DESCRIPTION 544 
INTRODUCING THE DESCRIPTION CLEARLY 545 
PROVIDING APPROPRIATE DETAIL 546 

a GUIDELINES: Providing Appropriate Detail in Descriptions 547 
ENDING THE DESCRIPTION WITH A BRIEF CONCLUSION 547 
A LOOK AT SEVERAL SAMPLE DESCRIPTIONS 548 

Writing Instructions 551 

UNDERSTANDING THE ROLE OF INSTRUCTIONAL VIDEOS 554 
DESIGNING A SET OF WRITTEN INSTRUCTIONS 555 

■ GUIDELINES: Designing Clear, Attractive Pages 557 
PLANNING FOR SAFETY 558 

a ETHICS NOTE: Ensuring Your Readers' Safety 558 
DRAFTING EFFECTIVE INSTRUCTIONS 560 

a GUIDELINES: Drafting Introductions for Instructions 561 
a GUIDELINES: Drafting Steps in Instructions 562 
REVISING, EDITING, AND PROOFREADING INSTRUCTIONS 563 



A LOOK AT SEVERAL SAMPLE SETS OF INSTRUCTIONS 563 

a DOCUMENT ANALYSIS ACTIVITY: Presenting Clear Instructions 568 

■ DOCUMENT ANALYSIS ACTIVITY: Mechanism Description Using Interactive 
Graphics 569 and S3 

a DOCUMENT ANALYSIS ACTIVITY: Process Description Using Video 
Animation 569 and 

■ DOCUMENT ANALYSIS ACTIVITY: Instructions Using Video 
Demonstration 569 and S3 

■ DOCUMENT ANALYSIS ACTIVITY: Instructions Using Video Screen 
Capture 569 and S3 

■ DOCUMENT ANALYSIS ACTIVITY: Instructions Using a Combination of Video 
Demonstration and Screen Capture 569 and S3 

■ DOCUMENT ANALYSIS ACTIVITY: Definition Using Video Animation 569 and 

Writing Manuals 569 


WRITER'S CHECKLIST 571 
EXERCISES 573 

CASE 20: Choosing a Medium for Presenting Instructions 575 and 


THIS CHAPTER DISCUSSES definitions, descriptions, and instructions. The first 
step is to define these three terms: 

• A definition is typically a brief explanation, using words and sometimes 
graphics, of what an item is or what a concept means. You could write a 
definition of file format or of regenerative braking. 

• A description is typically a longer explanation — usually accompanied by 
graphics — of the physical or operational features of an object, mechanism, or 
process. You could write a description of a wind turbine, of global warming, or 
of shale-oil extraction. 

• A set of instructions is a kind of process description, almost always accompanied 
by graphics, intended to enable a person to carry out a task. You could write a 
set of instructions for installing a new roof or for using an app on your tablet. 

Although each can appear independently, definitions, descriptions, and 
instructions are often presented together in a set of product information. For 
instance, a store that sells building materials for homeowners might create a 
product-information set about how to lay a brick patio. In this set might be 
definitions of tools (such as a mason's line), descriptions of objects (such as 
different types of edging materials, including plastic, metal, masonry, and wood), 
and step-by-step instructions for planning, laying, and maintaining the patio. 

Regardless of your field, you will write definitions, descriptions, and 
instructions frequently. Whether you are communicating with other technical 
professionals, with managers, or with the public, you must be able to define key 
concepts, describe processes, and explain how to carry out tasks. 
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Writing Definitions 

The world of business and industry depends on clear definitions. Suppose 
you learn at a job interview that the prospective employer pays tuition and 
expenses for employees’ job-related education. You would need to study the 
employee-benefits manual to understand just what the company would pay 
for. Who, for instance, is an employee? Is it anyone who works for the company, 
or is it someone who has worked for the company full-time (40 hours per 
week) for at least six uninterrupted months? What is tuition? Does it include 
incidental laboratory or student fees? What is job-related education? Does a 
course about time management qualify? What, in fact, constitutes education? 

Definitions are common in communicating policies and standards “for the 
record.” Definitions also have many uses outside legal or contractual con- 
texts. Two such uses occur frequently: 

• Definitions clarify a description of a new development or a new technology 
in a technical field. For instance, a zoologist who has discovered a new 
animal species names and defines it. 

• Definitions help specialists communicate with less-knowledgeable readers. 

A manual explaining how to tune up a car includes definitions of parts 
and tools. 

Definitions, then, are crucial in many kinds of technical communication, 
from brief letters and memos to technical reports, manuals, and journal 
articles. All readers, from the general reader to the expert, need effective defi- 
nitions to carry out their jobs. 

ANALYZING THE WRITING SITUATION FOR DEFINITIONS 

The first step in writing effective definitions is to analyze the writing situa- 
tion: the audience and the purpose of the document. 

Unless you know who your readers will be and how much they know about 
the subject, you cannot determine which terms to define or what kind of 
definition to write. Physicists wouldn’t need a definition of entropy, but lawyers 
might. Builders know what a molly bolt is, but many insurance agents don’t. 

When you write for people whose first language is not English, definitions 
are particularly important. Consider the following four suggestions: 

• For longer documents, create a glossary (a list of definitions). For more on 
glossaries, see Chapter 18, page 484. 

• Use Simplified English and easily recognizable terms in definitions. For more 
on Simplified English, see Chapter 10, page 242. 

• Pay close attention to key terms. Be sure to carefully define terms that are 
essential for understanding the document. If, for instance, your document is 
about angioplasty, you will want to be especially careful when defining it. 

• Use graphics to help readers understand a term or concept. Graphics are 
particularly helpful to readers who speak different languages, and they 
reduce the cost of translating text from one language to another. 


For more about audience and 
purpose, see Ch. 5. 
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Think, too, about your purpose. For readers who need only a basic under- 
standing of a concept — say, travellers researching lodging options who want 
to learn more about timesharing vacation resorts — a brief, informal definition 
is usually sufficient. However, readers who need to understand an object, 
process, or concept thoroughly and be able to carry out tasks related to it 
need a more formal and elaborate definition. For example, the definition of a 
“Class 2 Alert” written for operators at a nuclear power plant must be com- 
prehensive, specific, and precise. 

DETERMINING THE KIND OF DEFINITION TO WRITE 

Your audience and purpose will also determine the length and formality of 
your definitions. There are three basic types of definitions: parenthetical, sen- 
tence, and extended. 

Writing Parenthetical Definitions A parenthetical definition is a brief 
clarification within an existing sentence. Sometimes, a parenthetical defini- 
tion is simply a word or phrase that is enclosed in parentheses or commas 
or introduced by a colon or a dash. In the following examples, the term being 
defined is shown in italics, and the definition is underscored: 

The computers were infected by a Trojan horse ( a destructive program that appears to 
be benign ). 

Before the metal is plated, it is immersed in the pickle-, an acid bath that removes 
scales and oxides from the surface. 

Parenthetical definitions are not meant to be comprehensive; rather, they 
serve as quick and convenient ways of introducing terms. But make sure your 
definition is clear. You have gained nothing if readers don’t understand it: 

Next, check for blight on the epicotyl, the stem portion above the cotyledons. 

Readers who need a definition of epicotyl are unlikely to know the meaning of 
cotyledons. To solve this problem, think carefully about your readers’ under- 
standing of your subject before including technical terms specific to that 
subject. 

Writing Sentence Definitions A sentence definition — a one-sentence 
clarification — is more formal than a parenthetical definition. A sentence 
definition usually follows a standard pattern: the item to be defined is placed 
in a category of similar items and then distinguished from them. 

ITEM = CATEGORY + DISTINGUISHING CHARACTERISTICS 

Crippleware is shareware in which some features of the 


program are disabled until the user 
buys a license to use the program. 


Hypnoanalysis is a psychoanalytical 
technique 


in which hypnosis is used to 
elicit information from a patient's 
unconscious mind. 
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In many cases, a sentence definition also includes a graphic. For example, 
a definition of an electron microscope would probably include a photograph, 
diagram, or drawing. 

Writers often use sentence definitions to present a working definition 
for a particular document: “In this report, electron microscope refers to any 
microscope that uses electrons rather than visible light to produce magnified 
images.” Such definitions are sometimes called stipulative definitions because 
the writer is stipulating how the term will be used in the context of the docu- 
ment rather than offering a general definition of the term. 


The following four suggestions can help you write effective sentence definitions. 

► Be specific in stating the category and the distinguishing characteristics. If you 

write, "A Bunsen burner is a burner that consists of a vertical metal tube con- 
nected to a gas source,"the imprecise category — "a burner" — ruins the definition: 
many types of large-scale burners use vertical metal tubes connected to gas 
sources. 

► Don't describe a specific item if you are defining a general class of items. If you 

wish to define catamaran, don't describe a particular catamaran. The catamaran 
you see on the beach in front of you might be made by Hobie and have a white 
hull and blue sails, but those characteristics are not features of catamarans in 


► Avoid writing circular definitions — that is, definitions that merely repeat the 
key words or the distinguishing characteristics of the item being defined in the 
category. The definition "A required course is a course that is required" is useless: 
required of whom, by whom? However, in defining electron microscopes, you 
can repeat microscope because microscope is not the difficult part of the item. 
The purpose of defining electron microscope is to clarify electron as it applies to a 
particular type of microscope. 

► Be sure the category contains a noun or a noun phrase rather than a phrase 
beginning with when, what, or where. 

incorrect A brazier is what is used to 

correct A brazier is a metal pan used to 

incorrect Hypnoanalysis is when hypnosis is used to 

correct Hypnoanalysis is a psychoanalytical technique in which 


Writing Extended Definitions An extended definition is a more-detailed 
explanation — usually one or more paragraphs — of an object, process, or idea. 
Often an extended definition begins with a sentence definition, which is 
then elaborated. For instance, the sentence definition “An electrophorus is a 
laboratory instrument used to generate static electricity” tells you the basic 
function of the device, but it doesn’t explain how it works, what it is used for, 


4\ 
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general. 





538 


20 


WRITING DEFINITIONS, DESCRIPTIONS, AND INSTRUCTIONS 


The graphic effectively and eco- 
nomically clarifies the concept of 
additive color. 


This extended definition is effective 
because the writer has presented a 
clear sentence definition followed 
by numerous examples. 


For more about partitioning, see 
Ch.7,p. 160. 


or its strengths and limitations. An extended definition would address these 
and other topics. 

There is no one way to “extend” a definition. Your analysis of your audi- 
ence and the purpose of your communication will help you decide which 
method to use. In fact, an extended definition sometimes employs several of 
the eight techniques discussed here. 

Graphics Perhaps the most common way to present an extended definition 
in technical communication is to include a graphic and then explain it. 
Graphics are useful in defining not only physical objects but also concepts 
and ideas. A definition of temperature inversion, for instance, might include a 
diagram showing the forces that create temperature inversions. 

The following passage from an extended definition of additive color shows 
how graphics can complement words in an extended definition. 

Additive color is the type of color that results from 
mixing colored light, as opposed to mixing pigments 
such as dyes or paints. When any two colored lights 
are mixed, they produce a third color that is lighter 
than either of the two original colors, as shown in this 
diagram. And when green, red, and blue lights are 
mixed together in equal parts, they form white light. 

We are all familiar with the concept of additive color 
from watching TV monitors. A TV monitor projects 
three beams of electrons — one each for red, blue, and 
green — onto a fluorescent screen. Depending on the 
combinations of the three colors, we see different colors on the screen. 

Examples Examples are particularly useful in making an abstract term easier 
to understand. The following paragraph is an extended definition of hazing 
activities (Fraternity Insurance, 2013). 

No chapter, colony, student or alumnus shall conduct or condone hazing activities. 
Hazing activities are defined as: "Any action taken or situation created, intentionally, 
whether on or off fraternity premises, to produce mental or physical discomfort, 
embarrassment, harassment, or ridicule. Such activities may include but are not 
limited to the following: use of alcohol; paddling in any form; creation of excessive 
fatigue; physical and psychological shocks; quests, treasure hunts, scavenger hunts, 
road trips or any other such activities carried on outside or inside of the confines of 
the chapter house; wearing of public apparel which is conspicuous and not normally 
in good taste; engaging in public stunts and buffoonery; morally degrading or 
humiliating games and activities; and any other activities which are not consistent 
with academic achievement, fraternal law, ritual or policy or the regulations and 
policies of the educational institution or applicable state law." 

Partition Partitioning is the process of dividing a thing or an idea into 
smaller parts so that readers can understand it more easily. The following 
example (Brain, 2005) uses partition to define computer infection. 
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Types of Infection 

When you listen to the news, you hear about many different forms of electronic 
infection. The most common are: 

• Viruses — A virus is a small piece of software that piggybacks on real programs. For 
example, a virus might attach itself to a program such as a spreadsheet program. 
Each time the spreadsheet program runs, the virus runs, too, and it has the chance 
to reproduce (by attaching to other programs) or wreak havoc. 

• E-mail viruses — An e-mail virus moves around in e-mail messages, and usually 
replicates itself by automatically mailing itself to dozens of people in the victim's 
e-mail address book. 

• Worms — A worm is a small piece of software that uses computer networks and 
security holes to replicate itself. A copy of the worm scans the network for another 
machine that has a specific security hole. It copies itself to the new machine using 
the security hole, and then starts replicating from there, as well. 

• Trojan horses — ATrojan horse is simply a computer program. The program claims 
to do one thing (it may claim to be a game) but instead does damage when you run 
it (it may erase your hard disk). Trojan horses have no way to replicate automatically. 

Principle of Operation Describing the principle of operation — the way 
something works — is an effective way to develop an extended definition, 
especially for an object or a process. The following excerpt from an extended 
definition of adaptive cruise control (Canadian Association, 2009) is based on 
the mechanism’s principle of operation. 

Adaptive cruise control (ACC) employs 
sensing and control systems to monitor the 
vehicle's position with respect to any vehicle 
ahead. When a vehicle equipped with ACC 
approaches a slower moving vehicle, the 
ACC system reduces the vehicle speed in 
order to maintain a preset following distance 
(headway). However, when the traffic 
ahead clears, the ACC system automatically 
accelerates the vehicle back to the preset 
travel speed. 

ACC systems use forward-looking radar or 
laser detection (lidar) systems to monitor the 
vehicle's position with respect to any vehicle 
in front and change the speed in order to 
maintain a preset following distance (headway) 

The system typically allows the driver to preset 
a "following time," for example a two-second 
gap between vehicles. The ACC computer 
makes calculations of speed, distance and 
time based on the sensor inputs and makes 
appropriate adjustments to the vehicle's speed 
to maintain the desired headway. 



The ACC system in the green car detects the slower-moving red car. 



ACC reduces the green car's speed and maintains the preset headway. 



The green car overtakes the red car. The road ahead is clear. The ACC 
system resumes the vehicle's preset cruising speed. 



540 


20 


WRITING DEFINITIONS, DESCRIPTIONS, AND INSTRUCTIONS 


For more about comparison and 
contrast, see Ch. 7, p. 156. 


In this excerpt, the second and 
third paragraphs briefly compare 
VoIP and traditional phone service. 
Notice that this passage is orga- 
nized according to the part-by-part 
comparison-and-contrast pattern. 
For more about this organizational 
pattern, see Ch. 7, p. 1 57. 


The writer of this passage uses the 
analogy of gutting a house to clarify 
the meaning of decellularization. 


Comparison and Contrast Using comparison and contrast, a writer 
discusses the similarities or differences between the item being defined and 
an item with which readers are more familiar. The following definition of 
VoIP (Voice over Internet Protocol) contrasts this new form of phone service 
to the form we all know. 

Voice over Internet Protocol is a form of phone service that lets you connect to 
the Internet through your cable or DSL modem. VoIP service uses a device called a 
telephony adapter, which attaches to the broadband modem, transforming phone 
pulses into IP packets sent over the Internet. 

VoIP is considerably cheaper than traditional phone service: for as little as $20 per 
month, users get unlimited local and domestic long-distance service. For international 
calls, VoIP service is only about three cents per minute, about a third the rate of 
traditional phone service. In addition, any calls from one person to another person 
with the same VoIP service provider are free. 

However, sound quality on VoIP cannot match that of a traditional land-based 
phone. On a good day, the sound is fine on VoIP, but frequent users comment on 
clipping and dropouts that can last up to a second. In addition, sometimes the sound 
has the distant, tinny quality of some of today's cell phones. 

Analogy An analogy is a specialized kind of comparison. In a traditional 
comparison, the writer compares one item to another, similar item: an 
electron microscope to a light microscope, for example. In an analogy, 
however, the item being defined is compared to an item that is in some 
ways completely different but that shares some essential characteristic. 

For instance, the central processing unit of a computer is often compared 
to a brain. Obviously, these two items are very different, except that the 
relationship of the central processing unit to the computer is similar to that 
of the brain to the body. 

The following example from a definition of decellularization (Falco, 2008) 
shows an effective use of an analogy. 

Researchers at the University of Minnesota were able to create a beating [rat] heart 
using the outer structure of one heart and injecting heart cells from another rat. 

Their findings are reported in the journal Nature Medicine. Rather than building a 
heart from scratch, which has often been mentioned as a possible use for stem cells, 
this procedure takes a heart and breaks it down to the outermost shell. It's similar 
to taking a house and gutting it, then rebuilding everything inside. In the human 
version, the patient's own cells would be used. 

Negation A special kind of contrast is negation, sometimes called negative 
statement. Negation clarifies a term by distinguishing it from a different term 
with which readers might confuse it. The following example uses negation to 
distinguish the term ambulatory from ambulance. 

An ambulatory patient is not a patient who must be moved by ambulance. On the 
contrary, an ambulatory patient is one who can walk without assistance from another 
person. 
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Negation is rarely the only technique used in an extended definition; in 
fact, it is used most often in a sentence or two at the start. Once you have 
explained what something is not, you still have to explain what it is. 

Etymology Citing a word’s etymology, or derivation, is often a useful and 
interesting way to develop a definition. The following example uses the 
etymology of spam — unsolicited junk email — to define it. 

For many decades, Hormel Foods has manufactured a luncheon meat called Spam, 
which stands for "Shoulder Pork and hAM"/"SPiced hAM."Then, in the 1970s, the 
English comedy team Monty Python's Flying Circus broadcast a skit about a restaurant 
that served Spam with every dish. In describing each dish, the waitress repeats the 
word Spam over and over, and several Vikings standing in the corner chant the 
word repeatedly. In the mid-1 990s, two businessmen hired a programmer to write a 
program that would send unsolicited ads to thousands of electronic newsgroups. Just 
as Monty Python's chanting Vikings drowned out other conversation in the restaurant, 
the ads began drowning out regular communication online. As a result, people 
started calling unsolicited junk e-mail spam. 

Etymology is a popular way to begin definitions of acronyms, which are 
abbreviations pronounced as words: 

RAID, which stands for redundant array of independent (or inexpensive) disks, refers 
to a computer storage system that can withstand a single (or, in some cases, even 
double) disk failure. 

Etymology, like negation, is rarely used alone in technical communication, 
but it provides an effective way to introduce an extended definition. 

A Sample Extended Definition Figure 20.1 on page 542 is an example of an 
extended definition addressed to a general audience. 

DECIDING WHERE TO PLACE THE DEFINITION 

If you are writing a sentence definition or an extended definition, you need 
to decide where to put it. A definition is typically placed in one of these six 
locations: 

• In the text. The text is an appropriate place for sentence definitions that 
many or most of your readers will need and for extended definitions of 
important terms. 

• In a marginal gloss. Sentence definitions placed in the margin are easy to 
see, and they don’t interrupt readers who don’t need them. 

• In a hyperlink. In a web page, definitions can be put in a separate file and 
displayed. 

• In a footnote. A footnote is a logical place for an occasional sentence 
definition or extended definition. The reader who doesn’t need it will 
ignore it. However, footnotes can slow readers down by interrupting 
the flow of the discussion. If you think you will need more than one 
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FIGURE 20.1 An 
Extended Definition 

Source: GPS.gov, 201 3: http://www.gps 
.g o v/sy ste m s/g p s/. 


The first paragraph of this extended 
definition of GPS begins with a 
sentence definition. 


The second sentence serves as an 
advance organizer for the defini- 
tion, explaining that the definition 
will be extended by partition: GPS 
consists of three segments. 


The body of this extended defini- 
tion consists of three sections, each 
of which is introduced by a graphic 
and a topic sentence explaining the 
segment. 


Links lead the reader to much more 
information about each segment, 
including more text, diagrams, and 
videos. 




What is GPS? 


■* The Global Positioning System (GPS) is a U.S. -owned utility that 
provides users with positioning, navigation, and timing (PNT) 
services. This system consists of three segments: the space 
segment, the control segment, and the user segment. The U.S. Air 
Force develops, maintains, and operates the space and control 
segments. 


Control Segment 

The control segment consists of worldwide 
monitor and control stations that maintain the 
satellites in their proper orbits through 
occasional command maneuvers, and adjust the 
satellite clocks. It tracks the GPS satellites, 
uploads updated navigational data, and 
maintains health and status of the satellite 
constellation . ''learn more... 


User Segment 

The user segment consists of the GPS receiver 
equipment, which receives the signals from the 
GPS satellites and uses the transmitted 
information to calculate the user’s three- 
dimensional position and time, learn hoy/ gps is 
used... 


Space Segment 

The space segment consists of a nominal 
constellation of 24 operating satellites that 
transmit one-way signals that give the current 
GPS satellite position and time, learn more... ^ 
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footnote for a definition on every two to three pages, consider including 
a glossary. 

• In a glossary. A glossary — an alphabetized list of definitions — can 
accommodate sentence definitions and extended definitions of fewer than 
three or four paragraphs in one convenient location. A glossary can be 
placed at the beginning of a document (for example, after the executive 
summary in a report) or at the end, preceding the appendixes. 

• In an appendix. An appendix is appropriate for an extended definition of a 
page or more, which would be cumbersome in a glossary or footnote. 


Writing Descriptions 

Technical communication often requires descriptions: verbal and visual rep- 
resentations of the physical or operational features of objects, mechanisms, 
and processes. 

• Objects. An object is anything from a natural physical site, such as a 
volcano, to a synthetic artifact, such as a battery. A tomato plant is an 
object, as is an automobile tire or a book. 

• Mechanisms. A mechanism is a synthetic object consisting of a number of 
identifiable parts that work together. A cell phone is a mechanism, as is a 
voltmeter, a lawnmower, or a submarine. 

• Processes. A process is an activity that takes place over time. Species 
evolve; steel is made; plants perform photosynthesis. Descriptions of 
processes, which explain how something happens, differ from instructions, 
which explain how to do something. Readers of a process description 
want to understand the process; readers of instructions want a step-by-step 
guide to help them perform the process. 

Descriptions of objects, mechanisms, and processes appear in virtually 
every kind of technical communication. For example, an employee who 
wants to persuade management to buy some equipment includes a descrip- 
tion of the equipment in the proposal to buy it. A company manufacturing 
a consumer product provides a description and a photograph of the product 
on its website to attract buyers. A developer who wants to build a housing 
project includes in his proposal to municipal authorities descriptions of the 
geographical area and of the process he will use in developing that area. 

Typically, a description is part of a larger document. For example, a main- 
tenance manual for an air-conditioning system might begin with a descrip- 
tion of the system to help the reader understand first how it operates and 
then how to fix or maintain it. 


For more about glossaries and 
appendixes, see Ch. 18, pp. 484 and 
487. 


ANALYZING THE WRITING SITUATION FOR DESCRIPTIONS 

Before you begin to write a description, consider carefully how the audi- 
ence and the purpose of the document will affect what you write. What does 
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For more about titles and headings, 
see Ch. 9, pp. 193 and 1 94. 


the audience already know about the general subject? For example, if you 
want to describe how the next generation of industrial robots will affect car 
manufacturing, you first have to know whether your readers understand the 
current process and whether they understand robotics. 

Your sense of your audience will determine not only how technical your 
vocabulary should be but also how long your sentences and paragraphs 
should be. Another audience-related factor is your use of graphics. Less- 
knowledgeable readers need simple graphics; they might have trouble under- 
standing sophisticated schematics or decision charts. As you consider your 
audience, think about whether any of your readers are from other cultures 
and might therefore expect different topics, organization, or writing style in 
the description. 

Consider, too, your purpose. What are you trying to accomplish with 
this description? If you want your readers to understand how a personal 
computer works, write a general description that applies to several brands 
and sizes of computers. If you want your readers to understand how a 
specific computer works, write a particular description. A general descrip- 
tion of personal computers might classify them by size, then go on to 
describe desktops, laptops, and tablets in general terms. A particular 
description, however, will describe only one model of personal computer, 
such as a Millennia 2500. Your purpose will determine every aspect of the 
description, including its length, the amount of detail, and the number 
and type of graphics. 

There is no single organization or format used for descriptions. Because 
descriptions are written for different audiences and different purposes, they 
can take many shapes and forms. However, the following four suggestions 
will guide you in most situations: 

• Indicate clearly the nature and scope of the description. 

• Introduce the description clearly. 

• Provide appropriate detail. 

• End the description with a brief conclusion. 

INDICATING CLEARLY THE NATURE AND 
SCOPE OF THE DESCRIPTION 

If the description is to be a separate document, give it a title. If the descrip- 
tion is to be part of a longer document, give it a section heading. In either 
case, clearly state the subject and indicate whether the description is gen- 
eral or particular. For instance, a general description of an object might be 
entitled “Description of a Minivan,” and a particular description, “Descrip- 
tion of the 2015 Honda Odyssey.” A general description of a process might 
be called “Description of the Process of Designing a New Production Car,” 
and a particular description, “Description of the Process of Designing the 
Chevrolet Malibu.” 
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INTRODUCING THE DESCRIPTION CLEARLY 

Provide any information that readers need in order to understand the 
detailed information that follows. Most introductions to descriptions are gen- 
eral: you want to give readers a broad understanding of the object, mecha- 
nism, or process. You might also provide a graphic that introduces your read- 
ers to the overall concept. For example, for a process, you might include a 
flowchart summarizing the steps in the body of the description; for an object, 
such as a bicycle, you might include a photograph or a drawing showing the 
major components you will describe in detail in the body. 

Table 20.1 shows some of the basic kinds of questions you might want to 
answer in introducing object, mechanism, and process descriptions. If the 
answer is obvious, simply move on to the next question. 


TABLE 20.1 Questions To Answer in Introducing a Description 


FOR OBJECT AND MECHANISM DESCRIPTIONS FOR PROCESS DESCRIPTIONS 

• What is the item? You might start with a sentence • What is the process? You might start with a sentence 

definition. definition. 


What is the function of the item? If the function is not 
implicit in the sentence definition, state it:"Electron 
microscopes magnify objects that are smaller than the 
wavelengths of visible light." 

What does the item look like? Sometimes an object is 
best pictured with both graphics and words. Include a 
photograph or drawing if possible. (See Chapter 1 2 for 
more about incorporating graphics into your text.) If you 
cannot use a graphic, use an analogy or comparison:"The 
USB drive is a plastic- or metal-covered device, about the 
size of a pack of gum, with a removable cap that covers 
the type-A USB connection." Mention the material, texture, 
color, and other physical characteristics, if relevant. 

How does the item work? In a few sentences, define the 
operating principle. Sometimes objects do not "work"; they 
merely exist. For instance, a ship model has no operating 
principle. 

What are the principal parts of the item? Limit your 
description to the principal parts. A description of a bicycle, 
for instance, would not mention the dozens of nuts and 
bolts that hold the mechanism together; it would focus on 
the chain, gears, pedals, wheels, and frame. 


What is the function of the process? Unless the function is 
obvious, state it: "The main purpose of performing a census 
is to obtain current population figures, which government 
agencies use to revise legislative districts and determine 
revenue sharing." 

Where and when does the process take place? "Each year 
the stream is stocked with hatchery fish in the first week of 
March." Omit these facts only if your readers already know 
them. 

Who or what performs the process? If there is any doubt 
about who or what performs the process, state that 
information. 

How does the process work? "The four-treatment lawn- 
spray plan is based on the theory that the most effective 
way to promote a healthy lawn is to apply different 
treatments at crucial times during the growing season. The 
first two treatments — in spring and early summer — consist 
of . . . ." 

What are the principal steps in the process? Name the 
steps in the order in which you will describe them. The 
principal steps in changing an automobile tire, for instance, 
are jacking up the car, replacing the old tire with the new 
one, and lowering the car back to the ground. Changing a 
tire also includes secondary steps, such as placing chocks 
against the tires to prevent the car from moving once it is 
jacked up. Explain or refer to these secondary steps at the 
appropriate points in the description. 
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Clicking on any of the red dots 
opens a window with a one- 
sentence description and graphic, 
as well as a link to an extended 
description and more-detailed 
graphic. 

This web-based description 
includes six labeled systems. Here 
we see the expanded description 
of one of them: the regenerative 
braking system. 



Feature tour 

Explore some of the great 
features that distinguish this 
family of bikes. 




FIGURE 20.2 Graphic with Linked Graphics and Descriptions 

Source: Trek Bicycle Corporation, 2013: http://www.trekbikes.com/us/en/collections/electric_assist/feature_tour. Courtesy 
Trek Bicycle Corporation. 


Figure 20.2 shows the introductory graphic accompanying a description of 
an electric bicycle. 

PROVIDING APPROPRIATE DETAIL 

In the body of a description — the part-by-part or step-by-step section — treat 
each major part or step as a separate item. In describing an object or a 
mechanism, define each part and then, if applicable, describe its function, 
operating principle, and appearance. In discussing the appearance, include 
shape, dimensions, material, and physical details such as texture and color 
(if essential). Some descriptions might include other qualities, such as weight 
or hardness. 

In describing a process, treat each major step as if it were a separate pro- 
cess. Do not repeat your answer to the question about who or what performs 
the action unless a new agent performs it, but do answer the other important 
questions: what the step is; what its function is; and when, where, and how 
it occurs. 

A description can have not only parts or steps but also subparts or sub- 
steps. A description of a computer system includes a keyboard as one of its 
main parts, and the description of the keyboard includes the numeric keypad 
as one of its subparts. And the description of the numeric keypad includes 
the arrow keys as one of its subparts. The level of detail depends on the 
complexity of the item and the readers’ needs. The same principle applies 
in describing processes: if a step has substeps, you need to describe who or 
what performs each substep (if that is not obvious) as well as what the sub- 
step is, what its function is, and when, where, and how it occurs. 
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Providing Appropriate Detail in Descriptions 


Use the following techniques to flesh out your descriptions. 

FOR MECHANISM AND OBJECT DESCRIPTIONS 

► Choose an appropriate organizational principle. Descriptions can be organized 
in various ways. Two organizational principles are common: 

— Functional: how the item works or is used. In a radio, the sound begins at the 
receiver, travels into the amplifier, and then flows out through the speakers. 

— Spatial: based on the physical structure of the item (from top to bottom, east 
to west, outside to inside, and so forth). 

The description of a house, for instance, could be organized functionally (cover- 
ing the different electrical and mechanical systems) or spatially (top to bottom, 
inside to outside, east to west, and so on). A complex description can use differ- 
ent patterns at different levels. 

► Use graphics. Present a graphic for each major part. Use photographs to show 
external surfaces, drawings to emphasize particular items on the surface, and cut- 
aways and exploded diagrams to show details beneath the surface. Other kinds of 
graphics, such as graphs and charts, are often useful supplements (see Chapter 1 2). 

FOR PROCESS DESCRIPTIONS 

► Structure the step-by-step description chronologically. If the process is a closed 
system — such as the cycle of evaporation and condensation — and therefore has 
no first step, begin with any principal step. 

► Explain causal relationships among steps. Don't present the steps as if they had 
nothing to do with one another. In many cases, one step causes another. In the 
operation of a four-stroke gasoline engine, for instance, each step creates the 
conditions for the next step. 

► Use the present tense. Discuss steps in the present tense unless you are writing 

about a process that occurred in the historical past. For example, use the past 
tense in describing how the Snake River aquifer was formed: "The molten mate- 
rial condensed " However, use the present tense in describing how steel is 

made: "The molten material is then poured into "The present tense helps 

readers understand that, in general, steel is made this way. 

► Use graphics. Whenever possible, use graphics to clarify each point. Consider 
flowcharts or other kinds of graphics, such as photographs, drawings, and 
graphs. For example, in a description of how a four-stroke gasoline engine oper- 
ates, use diagrams to illustrate the position of the valves and the activity occur- 
ring during each step. 


ENDING THE DESCRIPTION WITH A BRIEF CONCLUSION 

A typical description has a brief conclusion that summarizes it and prevents 
readers from overemphasizing the part or step discussed last. 

A common technique for concluding descriptions of mechanisms and of 
some objects is to state briefly how the parts function together. At the end of 
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a description of how the Apple iPhone touch screen works, for example, the 
conclusion might include the following paragraph: 

When you touch the screen, electrical impulses travel from the screen to the iPhone 
processor, which analyzes the characteristics of the touch. These characteristics 
include the size, shape, and location of the touch, as well as whether you touched 
the screen in several places at once or moved your fingers. The processor then 
begins to process this data by removing any background noise and mapping and 
calculating the touch area or areas. Using its gesture-interpreting software, which 
combines these data with what it already knows about which function (such as the 
music player) you were using, the processor then sends commands to the music- 
player software and to the iPhone screen. How long does this process take? A 
nanosecond. 

Like an object or mechanism description, a process description usually 
has a brief conclusion: a short paragraph summarizing the principal steps. 
Here, for example, is the concluding section of a description of how a four- 
stroke gasoline engine operates: 

In the intake stroke, the piston moves down, drawing the air-fuel mixture into the 
cylinder from the carburetor. As the piston moves up, it compresses this mixture in 
the compression stroke, creating the conditions necessary for combustion. In the 
power stroke, a spark from the spark plug ignites the mixture, which burns rapidly, 
forcing the piston down. In the exhaust stroke, the piston moves up, expelling the 
burned gases. 

For descriptions of more than a few pages, a discussion of the implica- 
tions of the process might be appropriate. For instance, a description of 
the Big Bang might conclude with a discussion of how the theory has 
been supported and challenged by recent astronomical discoveries and 
theories. 


A LOOK AT SEVERAL SAMPLE DESCRIPTIONS 

A look at some sample descriptions will give you an idea of how different 
writers adapt basic approaches for a particular audience and purpose. 

Figure 20.3 shows the extent to which a process description can be based 
on a graphic. The topic is a household solar array. The audience is the general 
reader. 

Figure 20.4 on page 550 shows an excerpt from a mechanism description 
of three different types of hybrid drivetrains used in automobiles: series, 
parallel, and series/parallel. 

Figure 20.5 on page 552 shows an excerpt from a set of specifications for 
Logitech headphones. 

Figure 20.6 on page 553 is a description of the process of turning biomass 
into useful fuels and other products. 
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How Our Solar Electric System Works 

Your solar electric system is most likely to be what is called a direct grid-tie system. This means it is 
connected into the electricity system provided by your utility company. 

Here’s how it works . . . 

The sun strikes the panels of your solar array and a flow of direct current (DC) electricity is 
produced. This is the only type of current produced by solar cells. 

Appliances and machinery, however, are run on higher voltage alternating current (AC) electricity 
as supplied by your utility. 

The lower voltage DC is fed into an inverter that transforms it into alternating current. The AC 
feeds into the main electrical panel from which it powers your household’s or your business’s 
electrical needs. 


Your electrical panel is also connected to a specially installed bi-directional utility meter, this is 
connected to the electrical grid, which is the utility’s means of delivering electricity. This set up^ 
allows AC electricity to flow both into, and out of, your home or business. 


How Solar Works 


Sunlight 



Ouring the d«y, your solar electric system will be providing some, or oil, of your electrical needs. 


How much will depend, firstly, on the intensity of the sunlight; the system produces less power on 
cloudy days and during the winter months. It will also depend on the appliances or machinery you 
are running at the time. 

If your solar system is not providing all the power you need at any time, the balance is 
automatically provided by your utility. 

On days when sunlight is intense, your system may well produce more than you need. The excess 
is automatically fed into the grid. This is registered on your bi-directional meter which will spin 
backwards, giving you credit for the electricity you are providing. (This is known as net metering.) 

At night, your utility company automatically provides your electrical needs. 

If there is a utility power outage, your grid-tie system will shut down immediately for safety reasons. 

Your power will be reinstated moments after grid power is restored. 

A grid-tie solar electric system does not provide power during outages unless it incorporates a 
battery storage system. If your home or business has critical needs that require an uninterrupted 
power supply, we’ll be happy to take you through the various alternatives available to you. 

Off-grid, or stand-alone, solar systems produce power independently of the utility grid. They 
are most appropriate for remote or environmentally sensitive areas; stand-alone systems may 
effectively provide farm lighting, fence charging or solar water pumps. Most of these systems rely 
on battery storage so that power produced during the day can be used at night. 
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FIGURE 20.3 

A Process Description 
Based on a Graphic 

Source: Vanguard Energy Partners LLC, 2014: 
http://www.vanguardenergypartners 
.com/howsolarworks.html. Courtesy 
Vanguard Energy Partners LLC. 

This description begins with an 
informal definition of "direct grid- 
tie system." 

In the next section, the writer 
presents the steps of the process in 
chronological order. 

The description uses boldfaced text 
to emphasize key terms, most of 
which appear in the graphic. 

The description focuses on the 
operating principle of the system. 

It does not seek to explain the 
details of how the system works. 
Accordingly, the graphic focuses on 
the logic of the process, not on the 
particulars of what the components 
look like or where they are located 
in the house. 
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FIGURE 20.4 

Excerpt from a 
Mechanism Description 

Source: Hybrids Under the Hood 
(Part 2): Drivetrains, 201 3: http://www 
.hybridcenter.org/hybrid-center-how 
-hybrid-cars-work-under-the-hood-2 
.html. Used by permission of the Union 
of Concerned Scientists. 

This excerpt from a mechanism 
description begins with an advance 
organizer that helps the reader 
make the transition from the previ- 
ous section (a basic description of 
hybrid technology) to the present 
section, which discusses the three 
types of drivetrains. 

The interactive graphic enables 
the reader to view the principle of 
operation of three types of hybrid 
drivetrains, each during five modes. 
Here, the graphic shows how the 
components of the series drivetrain 
work together as the car operates 
at slow speeds. On the UCS website, 
the red and green striped lines are 
animated to highlight the compo- 
nents operating during the mode 
the reader has selected. 

For each of the three types of 
drivetrains, the text begins with a 
description of the operating princi- 
ple, followed by explanations of the 
strengths and weaknesses of the 
drivetrain. Notice that the audience 
and purpose of this description 
determine the kind of information 
it contains. Because this descrip- 
tion seeks to explain the operating 
principle behind each of the three 
types of drivetrains, it focuses on 
the drivetrains' functions, not on the 
materials they are made of or on 
their technical specifications. 


Drivetrains 

Now that we've covered the basic technology that defines hybrid vehicles, let's 
take a look at how they are put together to move the vehicle. The drivetrain of 
a vehicle is composed of the components that are responsible for transferring 
power to the drive wheels of your vehicle. With hybrids there are three possible 
setups for the drivetrain: the series drivetrain, the parallel drivetrain, and the 
series/parallel drivetrain. 





ELECTRONICS 


U 




/" «£p'"(_£ 

(JE> 


MOTOR : 



GASOLINE 

ENGINE 


Slow 

While driving at slow speeds, the Electronics simply draw power from the Battery to drive the 
Electric Motor, operating as a fully electric car. 


Off Accol Cruise Brake 

view: Series Parallel Series-Parallel 


Series Drivetrain 

This is the simplest hybrid configuration. In a series hybrid, the electric motor 
is the only means of providing power to get your wheels turning. The motor 
receives electric power from either the battery pack or from a generator run 
by a gasoline engine. A computer determines how much of the power comes 
from the battery or the engine/generator set. Both the engine/generator and 

regenerative braking recharge the battery pack While the engine in a 

conventional vehicle is forced to operate inefficiently in order to satisfy varying 
power demands of stop-and-go driving, series hybrids perform at their best 
in such conditions. This is because the gasoline engine in a series hybrid is not 
coupled to the wheels. This means the engine is no longer subject to the widely 
varying power demands experienced in stop-and-go driving and can instead 
operate in a narrow power range at near optimum efficiency 

Parallel Drivetrain 

Some up-and-coming hybrid models use a second electric motor to drive the 
rear wheels, providing electronic all-wheel drive that can improve handling and 
driving in bad weather conditions. 
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With a parallel hybrid electric vehicle, both the engine and the electric motor 
generate the power that drives the wheels. The addition of computer controls 
and a transmission allow these components to work together. This is the 
technology in the Insight, Civic, and Accord hybrids from Honda. Honda calls it 

their Integrated Motor Assist (IMA) technology Since the engine is connected 

directly to the wheels in this setup, it eliminates the inefficiency of converting 
mechanical power to electricity and back, which makes these hybrids quite 
efficient on the highway. Yet the same direct connection between the engine 
and the wheels that increases highway efficiency compared to a series hybrid 
does reduce, but not eliminate, the city driving efficiency benefits (i.e., the engine 
operates inefficiently in stop-and-go driving because it is forced to meet the 
associated widely varying power demands). 

Series/Parallel Drivetrains 

This drivetrain merges the advantages and complications of the parallel and 
series drivetrains. By combining the two designs, the engine can both drive the 
wheels directly (as in the parallel drivetrain) and be effectively disconnected 
from the wheels so that only the electric motor powers the wheels (as in the 
series drivetrain). The Toyota Prius has made this concept popular, and a similar 
technology is also in the new Ford Escape Hybrid. As a result of this dual 
drivetrain, the engine operates at near optimum efficiency more often 

Conclusion 

Knowing what's under the hood of hybrid electric vehicles will help you evaluate 
the available choices in the market. Considering most major auto manufacturers 
plan to release HEVs in the next few years, you'll be ready to choose the right one 
for you. Enjoy driving into the future. 


FIGURE 20.4 

(continued) 


This section of the description ends 
with a brief conclusion. 


FIGURE 20.4 Excerpt from a Mechanism Description ( continued ) 


Writing Instructions 

This section discusses instructions, which are process descriptions written to 
help readers perform a specific task — for instance, installing a water heater 
in a house. 

Although written instructions are still produced today, the growth of social 
media has radically changed how organizations instruct people on how to 
use their products and services. Now that technology has made it easy for 
people to participate in writing instructions and to view and make videos, 
most organizations try to present instructional material not only as formal 
written instructions but also through discussion boards, wikis, and videos. 
And users do not rely exclusively on the organizations themselves to create 
and present instructions. Rather, they create their own text and videos. 

Most organizations do not see this participation as a threat. A 2012 survey 
of more than 500 organizations (Abel, 2013) suggests that organizations are 
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FIGURE 20.5 

Specifications 

Source: Logitech, 201 2: http://logitech 

-en-amr.custhelp.com/app/answers 

/detail/a_id/33976/~/logitech-ue 

-9000-wireless-headphones-technical 

-specifications. Used with permission of 

Logitech. 

An important kind of description 
is called a specification. A typical 
specification (or spec) consists of a 
graphic and a set of statistics about 
the device and its performance 
characteristics. Specifications help 
readers understand the capabilities 
of an item. You will see specifica- 
tions on devices as small as transis- 
tors and as large as aircraft carriers. 


Because this web-based spec sheet 
accompanies a consumer product, 
the arrangement of the specs is 
geared toward the interests of the 
likely purchasers. The audio specs 
are presented before the power 
specs because potential purchas- 
ers of high-end headphones will 
be most interested in the sound 
quality. 


Logitech UE 9000 Wireless Headphones Technical Specifications 




Logitech UE 8000 Wireless Headphones 



Model Number (MfN) 

PID - MlN - S(N location | 

Headphone* 

A- 00041 

M'N, PfN On headband behind left ear cup 
PID On headband behind nglt ear cup 


NOTE Motmakon is for reference only and may be subject to change 


General Product Information 

[Compliance Certification (CE) Link] 

Warranty 1 Self Help 

Please see the product support page fa warranty information and frequently asked questions 

Category 

Headphones 

Intended Usage 

iPod, iPhone. iPad, Smartphones, Tablet PC. Portable MP3.'me<ia players 

Software Support (at release) 

No software needed 


Headset/Headphones Specifications 

Available Image(s) 

ft Q 

Device Type 

Stereo 

Connection Type 

Wireless (USB fa charging only) 

Headband Dssign 

Over-the-head, Over-Uie-ear 

Frequency Response 

20 Hz to 20 kHz 

Input Impedance 

55 Ohms, 2K Ohms (with active noise cancellation enabled) 

Indicator Lights (LED) 

Power and banery 

Adjustable Headband 

Yes 

Inline Audio Controls 

PlayfPause, Volume control, Mdb -function 

Earcup Audio Controls 

Volume control. Power OrVOIT. Mub-functton, Push to talk 

Battery Details 

Rechargeable. Non-accessible 
Size Proprietary 
Quantity 1 
Type U-km 

Battery Ufe 

Recharge time. 3 5 hours (estimated) 
Discharge lime Up to 10 hours 

Power Adapter 

Yes (5v, 500mA) 

Cable Length 

6 feet a 1 8 meters 

Microphone 

Yes 

Microphone Specifications 

Microphone Type 

Bull-ln 

Connection Type 

Wireless 

Noise Canceling 

No 

Frequency Response 

100 Hz to 3 5 kHz 

Input Sensitivity 

Not available 


1 Product Dimensions 1; 

Product component 

Width 

DepthfLength 

Height 

Weight 

Headphones 

170 mm (8 7 inch) 

90 mm (3.5 Inch) 

190 mm (7 5 inch) 

330 o(11 8 ouice) 


Package Contents 

Available Image(s) 

^9 

What Is In the box 

Headphones. 3 5mm auteo cable. Case. User documentation. l/4-inch adapter jack. USB AC adapter. Micro-fiber polish ng doth 


Additional Product Information 


• Wireless Bluetooth headphones with microphone 

• Optional 3 5mm connection available with microphone and remote (Apple-specific) included 

• Controls on right ear cup = volume, rrnA -function, powenbluetooth 

• Controls on left ear cup = pusWo-talk. alows user to have (ace to lace conversations without removing headphones using external microphones 

• Control factions designed for Apple products but other devices may have limited functionality 

• Can connect to POMac w / bluetooth radios 
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Biochemical conversion uses 
biocatalysts, such as enzymes, 
in addition to heat and other 
chemicals, to convert the 
carbohydrate portion of the 
biomass (hemicellulose and 
cellulose) into an intermediate 
sugar stream. These sugars are 
intermediate building blocks 
that can then be fermented or 
chemically catalyzed into ethanol, 
other advanced biofuels, and 
value-added chemicals. The overall 
process can be broken into the 
following essential steps: 

A. Feedstock Supply: 

Feedstocks for biochemical 
processes are selected for 
optimum composition, 
quality, and size. Feedstock 
handling systems tailored to 
biochemical processing are 
essential to cost-effective, 
high-yield operations. 

B. Pretreatment: Biomass is 
heated (often combined with 
an acid or base) to break the 
tough, fibrous cell walls down 
and make the cellulose easier 
to hydrolyze (see next step). 

C. Hydrolysis: Enzymes (or other 
catalysts) enable the sugars in 
the pretreated material to be 
separated and released over a 
period of several days. 

D1. Biological Conversion: 

Microorganisms are added, 
which then use the sugars 
to generate other molecules 
suitable for use as fuels or 
building-block chemicals. 

D2. Chemical Conversion: Alternatively, the sugars can be converted to fuels or an 
entire suite of other useful products using chemical catalysis. 

E. Product Recovery: Products are separated from water, solvents, and any 
residual solids. 



Sugars & 
Intermediates 


The miiture ol sugars and any solids 
or urv reacted caliulota are transferred 
to a fermenter or a catalytic reactor. 


(Dy- v 

0T 

Biological 

Chemical 

Conversion 

ionversion 



Prt3fOI.;jfcdc/Kr732S5S: KlKk/45S6t6S fflOfcr KtKh/S&im 


F. Product Distribution: Fuels are transported to blending facilities, while other 
products and intermediates may be sent to traditional refineries or processing 
facilities for use in a diverse slate of consumer products. 

G. Heat & Power: The remaining solids are mostly lignin, which can be burned for 
heat and power. 
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FIGURE 20.6 An Effec- 
tive Process Description 

Source: U.S. Department of Energy, 20 1 3: 
wwwl .eere.energy.gov/bioenergy/pdfs 
/biochemical _four_pager.pdf. 


This description begins with an 
overview of the process of biochem- 
ical conversion: the process of using 
fermentation and catalysis to make 
fuels and products. 

The description includes a flowchart 
explaining the major steps in the 
process. The designers included 
photographs to add visual interest 
to the flowchart. 

The lettered steps in the flowchart 
correspond to the textual descrip- 
tions of the steps in the process. 

Most of the description is written 
in the passive voice (such as "Feed- 
stocks for biochemical processes 
are selected . . ."). The passive voice 
is appropriate because the focus of 
this process description is on what 
happens to the materials, not on 
what a person does. By contrast, in 
a set of instructions the focus is on 
what a person does. 
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trying to take advantage of it. Among the major survey findings are the fol- 
lowing four: 

• more than half of the respondents provide an online support community 
based around discussion boards 

• 46 percent of respondents provide opportunities for users to share 
feedback and rank the company’s instructional material 

• 20 percent of respondents let users create or edit instructions through 
wikis 

• 10 percent of respondents report that their users are creating their own 
instructions and support forums, without the support of the respondents 

Your first job, then, in presenting instructions is to devise a strategy for 
incorporating user participation in the process and to choose the best mix 
of media for encouraging that participation. Written instructions (whether 
presented online or printed and put in the box with the product) will always 
have a role because they are portable and can include as much detail as nec- 
essary for even the most complex tasks and systems. But consider whether 
your users will also benefit from access to other people’s ideas (in a discus- 
sion board or wiki) or from watching a video. 

UNDERSTANDING THE ROLE OF INSTRUCTIONAL VIDEOS 

The explosive growth of YouTube and other video-hosting sites has revolu- 
tionized how instructions are created and used. Product manufacturers and 
users alike make videos to help people understand how to perform tasks. 

If you are producing instructional videos on behalf of your company, think 
about what style of video will be most effective for your audience, purpose, and 
subject. Companies often use simple, cartoon-style videos for basic conceptual 
information (“what can you do with a microblog?”), screenshot-based videos 
for computer-based tasks (“how to use master slides in PowerPoint”), and live- 
action videos for physical tasks (“how to install a ground-fault interrupter”). 

Video is particularly useful for communicating about physical tasks that 
call for subtle physical movements or that involve both sight and sound. 

For instance, a video would be more effective than written instructions in 
communicating how a guitarist uses the tremolo bar to create different sonic 
effects. The viewer can focus on the way the guitarist holds his or her hand 
on the tremolo and on the range of movement that he or she uses. In addi- 
tion, the viewer can hear how these physical actions change the sound. 

Although there are many software tools available for making videos, mak- 
ing professional-quality videos calls for professional skills, experience, and 
tools. If you are going to be making many videos, it makes sense to learn the 
process and acquire professional tools and equipment; otherwise, consult your 
company’s media department or consider hiring freelance video producers. 
They can help you create videos that reflect positively on your organization. 

Instructional videos tend to be brief. Whereas a reader of a document can 
navigate easily among various parts or steps, viewers of a video can only 
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hit play, pause, and stop. For this reason, you should break long tasks into a 
series of brief videos: ideally 2-3 minutes, but no more than 12-15 minutes. 
Give each one a clear, specific title so viewers can easily tell whether they 
want to view it. 

Similarly, you should make your instructional videos simple and 
uncluttered. Software makes it easy to add a lot of cinematic effects, but 
less is often more. Your purpose is not to win an Academy Award; it is to 
help your audience learn how to carry out a task. The fewer distractions in 
the video, the easier it will be for viewers to see what to do. And remem- 
ber that video is a warm medium. Connect with the viewer by being 
friendly, informal, and direct. Don’t say, “Next, the right mouse button is 
pushed.” Say, “Press the right mouse button.” But do not confuse being 
warm and informal with not needing to prepare. You do need to plan, 
write a script, and rehearse. 

Be sure to build in the time and resources to revise the video. As discussed 
in Chapter 13, good technical communication calls for reviewing, revising, 
and testing. This concept applies to video. Start testing even before pro- 
duction. Make sure your script and visuals are right for your audience and 
purpose. And repeat the process after you have created the rough cut of the 
video and after each major revision. 

Use other sources responsibly. You need to obtain written permission to 
use any copyrighted text, images, videos, or music that will appear in your 
video. Because this process can be lengthy, difficult, and expensive, many 
organizations have a simple standing rule: do not use any copyrighted mate- 
rial. Instead, they generate their own images and text, and even their own 
music. 

DESIGNING A SET OF WRITTEN INSTRUCTIONS 

As you plan to write instructions, think about how readers will use them. 
Analyzing your audience and purpose and gathering and organizing your 
information will help you decide whether you should write a one-page set of 
instructions or a longer document that needs to be bound. You might realize 
that the information would work better as a web-based document that can 
include videos, be updated periodically, and provide readers with links to the 
information they need. Or you might decide to write several versions of the 
information: a brief paper-based set of instructions and a longer, web-based 
document with links. 

As always in technical communication, imagining how readers will 
use what you write will help you plan your document. For example, hav- 
ing decided that your audience, purpose, and subject call for a printed set 
of instructions of perhaps 1,000 words and a dozen drawings and photo- 
graphs, you can start to design the document. You will need to consider your 
resources, especially your budget: long documents cost more than short 
ones; color costs more than black and white; heavy paper costs more than 
light paper; secure bindings cost more than staples. 


For more about usability testing, see 
Ch. 13, p.348. 


For more about planning, see Ch. 3. 
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Designing a set of instructions is much like designing any other kind of tech- 
nical document. As discussed in Chapter 11, you want to create a document that 
is attractive and easy to use. When you design a set of instructions, you need to 
consider a number of issues related to document design and page design: 

• What are your readers' expectations? For a simple, inexpensive product, 
such as a light switch, readers will expect to find instructions written on 
the back of the package or printed in black and white on a small sheet of 
paper folded inside the package. For an expensive consumer product, such 
as a high-definition TV, readers will expect to find instructions in a more 
sophisticated full-color document printed on high-quality paper. 

• Do you need to create more than one set of instructions for different 
audiences? If you are writing about a complex device such as an electronic 
thermostat, you might decide to create one set of instructions for 
electricians (who will install and maintain the device) and one set for 
homeowners (who will operate the device). In addition to producing paper 
copies of the documents, you might want to post them on the Internet, 
along with a brief video of the tasks you describe. 

• What languages should you use? In most countries, several languages are 
spoken. You might decide to include instructions in two or more languages. 
Doing so will help you communicate better with more people, and it can 
help you avoid legal problems. In liability cases, U.S. courts sometimes find 
that if a company knows that many of its customers speak only Spanish, for 
example, the instructions should appear in Spanish as well as in English. 

You have two choices for presenting information in multiple languages: 
simultaneous presentation or sequential presentation. In a simultaneous 
design, you might use a multi-column page on which one column presents 
the graphics, another presents the text in English, and another presents the 
text in Spanish. Obviously, this won’t work if you need to present information 
in more than two or three languages. But it is efficient because you present 
each graphic only once. In a sequential design, you present all the information 
in English (say, on pages 1-8), then all the information in Spanish (on 

pages 9-16). The sequential design is easier for readers to use because they 
are not distracted by text in other languages, but you will have to present the 
graphics more than once, which will make the instructions longer. 

• Will readers be anxious about the information? If readers will find the 
information intimidating, make the design unintimidating. For instance, 
if you are writing for general readers about how to set up a wireless 
network for home computers, create open pages with a lot of white space 
and graphics. Use large type and narrow text columns so that each page 
contains a relatively small amount of information. Figure 20.7 illustrates 
the advantages of an open design. 

• Will the environment in which the instructions are read affect the document 
design? If people will be using the instructions outdoors, you will need 

to use a coated paper that can tolerate moisture or dirt. If people will be 
reading the instructions while sitting in a small, enclosed area, you might 
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select a small paper size and a binding that allows the reader to fold the 
pages over to save space. If people have a lot of room, you might decide to 
create poster-size instructions that can be taped to the wall and that are 
easy to read from across the room. 




FIGURE 20.7 
Cluttered and 
Attractive Page Designs 
in a Set of Instructions 


a. Cluttered design 
This page is cluttered, containing far too 
much information. In addition, the page 
is not chunked effectively. As a result, the 
reader's eyes don't know where to focus. 
Would you look forward to using these 
instructions to assemble a cabinet? 
Reprinted by permission of Slide-Lok. 


b. Attractive design 

This page is well designed, containing an appropriate 
amount of information presented in a simple two- 
column format. Notice the effective use of white 
space and the horizontal rules separating the steps. 
Reprinted by permission of Anthro Corporation. 


A 


GUIDELINES 


Designing Clear, Attractive Pages 


To design pages that are clear and attractive, follow these two guidelines: 


► Create an open, airy design. Do not squeeze too much information onto the 
page. Build in space for wide margins and effective line spacing, use large type, 
and chunk the information effectively. 

► Clearly relate the graphics to the text. In the step-by-step portion of a set of 
instructions, present graphics to accompany every step or almost every step. Cre- 
ate a design that makes it clear which graphics go with each text passage. One 
easy way to do this is to use a table, with the graphics in one column and the text 
in the other. A horizontal rule or extra line spacing separates the text and graph- 
ics for one step from the text and graphics for the next step. 


For more about chunking, see 
Ch. 1 1, p. 260. 
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WRITING DEFINITIONS, DESCRIPTIONS, AND INSTRUCTIONS 

PLANNING FOR SAFETY 

If the subject you are writing about involves safety risks, your most impor- 
tant responsibility is to do everything you can to ensure your readers’ 
safety. 


ETHICS NOTE 


ENSURING YOUR READERS' SAFETY 

To a large extent, the best way to keep your readers safe is to be honest and write clearly. If 
readers will encounter safety risks, explain what those risks are and how to minimize them. 
Doing so is a question of rights. Readers have a right to the best information they can get. 

Ensuring your readers' safety is also a question of law. People who get hurt can sue the com- 
pany that made the product or provided the service. As discussed in Chapter 2, this field 
of law is called liability law. Your company is likely to have legal professionals on staff or on 
retainer whose job is to ensure that the company is not responsible for putting people at 
unnecessary risk. 

When you write safety information, be clear and concise. Avoid compli- 
cated sentences. 

complicated It is required that safety glasses be worn when inside this laboratory. 

simple You must wear safety glasses in this laboratory. 

simple Wear safety glasses in this laboratory. 

Sometimes a phrase works better than a sentence: “Safety Glasses Required.” 

Because a typical manual or set of instructions can contain dozens of 
comments — some related to safety and some not — experts have devised 
signal words to indicate the seriousness of the advice. Unfortunately, signal 
words are not used consistently. For instance, the American National Stan- 
dards Institute (ANSI) and the U.S. military’s MILSPEC publish definitions that 
differ significantly, and many private companies have their own definitions. 
Figure 20.8 presents the four most commonly used signal words. The first 
three signal words are accompanied by symbols showing the color combina- 
tions endorsed by ANSI in its standard Z535.4. 

Whether safety information is printed in a document or on machinery 
or equipment, it should be prominent and easy to read. Many organizations 
use visual symbols to represent levels of danger, but these symbols are not 
standardized. 

Organizations that create products that are used only in the United States 
design safety information to conform with standards published by ANSI and 
by the federal Occupational Safety and Health Administration (OSHA). Orga- 
nizations that create products that are also used outside the United States 
design safety information to conform with standards published by the Inter- 
national Organization for Standardization (ISO). Figure 20.9 shows a safety 
label that incorporates both ANSI and ISO standards. 
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SIGNAL WORD EXPLANATION EXAMPLE 


Danger 


A DANGER 


Danger is used to alert DANGER: EXTREMELY HIGH 

readers about an immediate VOLTAGE. STAND BACK. 

and serious hazard that will 

likely be fatal. Writers often 

use all uppercase letters for 

danger statements. 


Warning 

AWARNING 


Warning is used to alert 
readers about the potential 
for serious injury or death 
or serious damage to 
equipment. Writers often 
use all uppercase letters for 
warning statements. 


WARNING:TO PREVENT 
SERIOUS INJURYTOYOUR 
ARMS AND HANDS, YOU 
MUST MAKE SURE THE ARM 
RESTRAINTS ARE IN PLACE 
BEFORE OPERATING THIS 
MACHINE. 


Caution 

A CAUTION 


Caution is used to alert 
readers about the potential 
for anything from moderate 
injury to serious equipment 
damage or destruction. 


Caution: Do not use 
nonrechargeable batteries in 
this charging unit; they could 
damage the charging unit. 


Note Note is used for a tip or Note: Two kinds of washers 

suggestion to help readers are provided — regular 

carry out a procedure washers and locking 

successfully. washers. Be sure to use the 

locking washers here. 


FIGURE 20.8 Signal Words 


Part of planning for safety is determin- 
ing the best location for safety information. 

This question has no easy answer because 
you cannot control how your audience 
reads your document. Be conservative: put 
safety information wherever you think the 
reader is likely to see it, and don’t be afraid 
to repeat yourself. A reasonable amount 
of repetition — such as including the same 
safety comment at the top of each page — is 
effective. But don’t repeat the same piece 
of advice in each of 20 steps, because readers will stop paying attention to it. 
If your company’s format for instructions calls for a safety section near the 
beginning of the document, place the information there and repeat it just 
before the appropriate step in the step-by-step section. 

Figure 20.10 shows one industry association’s guidelines for placing safety 
information on conveyor belts. 


A 

A DANGER 

Hazardous voltage 
inside. 

Disconnect power 
before servicing. 



FIGURE 20.9 A Typical 
Safety Label 

Source: Clarion Safety Systems, 2013: www 
.clarionsafety.com/Electrical-Hazard-Safety-Labels. 


The yellow triangle on the left is 
consistent with the ISO approach. 
Because ISO creates standards for 
international use, its safety labels 
use icons, not words, to represent 
safety hazards. 

The signal word "Danger" and 
the text are consistent with the 
ANSI approach. The information is 
presented in English. 
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FIGURE 20.10 Placement of Safety Information on 
Equipment 

Source: Conveyor Equipment Manufacturers Association, 2004. Reprinted by permission of 
Conveyor Equipment Manufacturers Association. 


DRAFTING EFFECTIVE INSTRUCTIONS 

Instructions can be brief (a small sheet of paper) or extensive (20 pages or 
more). Brief instructions might be produced by a writer, a graphic artist, and 
a subject-matter expert. Longer instructions might call for the assistance of 
others, such as marketing and legal personnel. 

Regardless of the size of the project, most instructions are organized like 
process descriptions. The main difference is that the conclusion of a set of 
instructions is not a summary but an explanation of how readers can make 
sure they have followed the instructions correctly. Most sets of instructions 
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contain four elements: a title, a general introduction, step-by-step instruc- 
tions, and a conclusion. 

Drafting Titles A good title for instructions is simple and clear. Two forms 
are common: 

• How-to. This is the simplest: “How to Install the J112 Shock Absorber.” 

• Gerund. The gerund form of a verb is the -ing form: “Installing the J112 
Shock Absorber.” 

One form to avoid is the noun string, which is awkward and difficult for read- For more about noun strings, see 

ers to understand: “J112 Shock Absorber Installation Instructions.” Ch - 10 , p.235. 

Drafting General Introductions The general introduction provides the 
preliminary information that readers will need to follow the instructions 
safely and easily. 


Every set of instructions is unique and therefore calls for a different introduction. 

Consider answering the following six questions, as appropriate: 

► Who should carry out this task? Sometimes you need to identify or describe the 
person or persons who are to carry out a task. Aircraft maintenance, for example, 
may be performed only by those certified to do it. 

► Why should the reader carry out this task? Sometimes the reason is obvious: 
you don't need to explain why a backyard barbecue grill should be assembled. 
But you do need to explain the rationale for many tasks, such as changing anti- 
freeze in a car's radiator. 

► When should the reader carry out this task? Some tasks, such as rotating tires or 
planting seeds, need to be performed at particular times or at particular intervals. 

► What safety measures or other concerns should the reader understand? In ad- 
dition to the safety measures that apply to the whole task, mention any tips that 
will make the job easier: 

NOTE: For ease of assembly, leave all nuts loose. Give only three or four 
complete turns on bolt threads. 

► What items will the reader need? List necessary tools, materials, and equipment 
so that readers will not have to interrupt their work to hunt for something. If you 
think readers might not be able to identify these items easily, include drawings 
next to the names. 

► How long will the task take? Consider stating how long the task will take readers 
with no experience, some experience, and a lot of experience. 


A 



Drafting Introductions for Instructions 


For more about graphics, see Ch. 1 2. 
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For more about the imperative mood 
and the passive voice, see Ch. 10, 
pp. 230 and 231. 


WRITING DEFINITIONS, DESCRIPTIONS, AND INSTRUCTIONS 

Drafting Step-by-Step Instructions The heart of a set of instructions is 
the step-by-step information. 


41 


GUIDELINES 


Drafting Steps in Instructions 


Follow these six suggestions for writing steps that are easy to understand. 


► Number the instructions. For long, complex instructions, use two-level number- 
ing, such as a decimal system: 

1 

1.1 

1.2 

2 

2.1 

2.2 

etc. 


If you need to present a long list of steps, group the steps logically into sets and 
begin each set with a clear heading. A list of 50 steps, for example, could be 
divided into 6 sets of 8 or 9 steps each. 


► Present the right amount of information in each step. Each step should define 
a single task the reader can carry out easily, without having to refer back to the 
instructions. 


too much information 1. Mix one part cement with one part water, 

using the trowel. When the mixture is a thick 
consistency without any lumps bigger than a 
marble, place a strip of the mixture about 1" 
high and V'wide along the face of the brick. 

too little information 1. Pick up the trowel. 


right amount of information 1. Mix one part cement with one part water, 

using the trowel, until the mixture is a thick 
consistency without any lumps bigger than a 
marble. 

2. Place a strip of the mixture about 1 " high and 
1 "wide along the face of the brick. 


► Use the imperative mood. The imperative mood expresses a request or a 

command — for example, "Attach the red wire."The imperative is more direct and 
economical than the indicative mood (“You should attach the red wire" or "The 
operator should attach the red wire"). Avoid the passive voice ("The red wire is 
attached"), because it can be ambiguous: is the red wire already attached? 


► Do not confuse steps and feedback statements. A step is an action that the 
reader is to perform. A feedback statement describes an event that occurs in re- 
sponse to a step. For instance, a step might read "Insert the disk in the drive."That 
step's feedback statement might read "The system will now update your user 
information." Do not present a feedback statement as a numbered step. Present 


(■ continued ) 
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it as part of the step to which it refers. Some writers give all feedback statements 
their own design. 

► Include graphics. When appropriate, add a photograph or a drawing to show the 
reader what to do. Some activities — such as adding two drops of a reagent to a 
mixture — do not need an illustration, but they might be clarified by a chart or a 
table. 

► Do not omit articles [a, an, the) to save space. Omitting articles can make the 
instructions unclear and hard to read. In the sentence "Locate midpoint and draw 
line," for example, the reader cannot tell if"draw line" is a noun (as in "locate the 
draw line") or a verb and its object (as in "draw a line"). 


Drafting Conclusions Instructions often conclude by stating that the 
reader has now completed the task or by describing what the reader should 
do next. For example: 

Now that you have replaced the glass and applied the glazing compound, let the 
window sit for at least five days so that the glazing can cure. Then, prime and paint the 
window. 

Some conclusions end with maintenance tips or a troubleshooting guide. A trou- 
bleshooting guide, usually presented as a table, identifies common problems 
and explains how to solve them. 

REVISING, EDITING, AND PROOFREADING INSTRUCTIONS 

You know, of course, to revise, edit, and proofread all the documents you 
write to make sure they are honest, clear, accurate, comprehensive, accessi- 
ble, concise, professional in appearance, and correct. When you write instruc- 
tions, you should be extra careful, for two reasons. 

First, your readers rely on your instructions to carry out a task. If they 
can’t complete it — or they do complete it, but they don’t achieve the expected 
outcome — they’ll be unhappy. Nobody likes to spend a few hours assembling 
a garage-door opener, only to find half a dozen parts left over. Second, your 
readers rely on you to help them complete the task safely. To prevent injuries 
and liability actions, build time into the budget to revise, edit, and proofread 
the instructions carefully. Then, if you can, carry out usability testing on the 
instructions. 

A LOOK AT SEVERAL SAMPLE SETS OF INSTRUCTIONS 

Figure 20.11 is an excerpt from a set of instructions. Figure 20.12 on page 565 
shows a list of tools and materials from a set of instructions. Figure 20.13 on 
page 566 is an excerpt from the safety information in a set of instructions. 
Figure 20.14 on page 567 is a portion of the troubleshooting guide in the 
instructions for a lawnmower. Figure 20.15 on page 567 is an excerpt from a 
thread in a discussion board. 


For more about usability testing, see 
Ch. 1 3, pp. 348-53. 
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This page from the user's manual for 
a tablet computer used in health- 
care environments discusses how to 
use the barcode scanner. 


Note that the writer uses a gerund 
(- ing phrase) in the major heading 
to describe the action ("Using the 
barcode scanner"). 

The writer explains why readers 
might want to scan barcodes. 

The writer lists the types of bar- 
codes the tablet can scan and then 
explains how to enable the tablet to 
scan additional types. Note that the 
more conceptual information about 
the task precedes the instructional 
information. Why? Because readers 
want to understand the big picture 
before getting into the details. 

The writer presents the steps. Note 
that the writer numbers the steps 
and uses the imperative mood for 
each one. 


The drawing helps readers under- 
stand how to hold the tablet and 
aim it at the barcode. In cases such 
as this, simple drawings work better 
than photographs because they do 
not distract readers with unneces- 
sary detail. 



Using the barcode scanner 


Your C5te/F5te is available with an optional integrated 1 D and 2D barcode scanner that you 
can use to retrieve information from barcodes. Many applications use barcodes for asset 
tracking, identification, and process controls. 


Supported barcode types 


The C5te/F5te barcode scanner supports several different types of barcodes — a minimum 
set of barcodes is enabled at the factory. 


The following symbologies are enabled by default: 


Aztec Code 
EAN-128 
Code 39 
UPC-A 
EAN-8 

Interleaved 2 of 5 
Micro PDF417 
RSS Umited 


Code 128 

EAN-UCC-CC-AB 

DataMatrix 

UPC-E 

EAN-13 

PDF417 

RSS-14 


Other barcode types can be enabled by using EasySet* by Intermec. This application can be 
installed by running setup, which is located here: C:\Motlon\Software\EasySet. 

To use the barcode scanner: 

1 . Open the application that you want to receive the barcode data and place the insertion 
point in the appropriate field. 

2. Hold the unit by the handle with the scanner lens in front of you. 

3. Aim the scanner lens at the barcode. 



Chapter 2 Using your C5te/F5te 


Using the barcode scanner 38 


FIGURE 20.1 1 Excerpt from a Set of Instructions 

Source: Motion Computing, 2013: http://www.motioncomputing.com/downloads/User_Docs/C5F5-Series/C5teF5te 
-UserGuide_Win8_EN.pdf. Courtesy Motion Computing. 
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Installation instructions 

PREPARE TO INSTALL THE RANGE 


FOR YOUR SAFETY: 

All rough-in and spacing dimensions must be 
met for safe use of your range. Electricity to 
the range can be disconnected at the outlet 
without moving the range if the outlet is in 
the preferred location (remove lower drawer). 

To reduce the risk of burns or fire when 
reaching over hot surface elements, cabinet 
storage space above the cooktop should be 
avoided, If cabinet storage space is to be 
provided above the cooktop, the risk can 
be reduced by installing a range hood that 
sticks out at least 5" beyond the front of the 
cabinets. Cabinets installed above a cooktop 
must be no deeper than 13" 

8e sure your appliance is properly installed 
and grounded by a qualified technician. 

Make sure the cabinets and wall coverings 
around the range can withstand the temperatures 
(up to 200 Q F.) generated by the range. 





\T\ REMOVE SHIPPING MATERIALS 

Remove packaging materials. Failure to 
remove packaging materials could result 
in damage to the appliance. 


Drawings of tools, materials, and 
parts are more effective than lists. 


FIGURE 20.12 List of Tools and Materials 

Courtesy of General Electric Corporation. 
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FIGURE 20.13 Excerpt 
from Safety Information 


This excerpt from a user manual for 
a video-game player that displays 
3D images describes two of the 
safety risks associated with playing 
video games. 

Notice that the excerpt uses 
mandatory language: "You 
must . . . ."Although politeness is 
desirable most of the time, you 
don't want to sound as if you were 
making suggestions or asking read- 
ers to do you favors. For instance, if 
a task calls for using safety goggles, 
do not write "You should consider 
wearing safety goggles." Instead, 
write "You must wear safety goggles 
when operating this equipment." 

This set of safety information 
defines the keywords warning, cau- 
tion, and important. 


The safety information goes on to 
discuss eyestrain and motion sick- 
ness, repetitive motion injuries, and 
radio frequency interference. 


HEALTH AND SAFETY INFORMATION 

You must read the following warnings before you set up or use the Orion 35 3D 
game system. If young children will be using this product, a competent adult 
must read and explain this safety information to them. Otherwise, these children 
could be injured. 

Also, you must carefully read the instruction booklet for the game you are 
playing to learn additional health and safety information. 

In this manual, you will see this symbol A followed by WARNING, CAUTION, or 
IMPORTANT. 

Here is what these three words mean: 

WARNING Describes an action that could lead to a serious personal injury or 
death. 

CAUTION Describes an action that could lead to personal injury or damage 
to the Orion 35 3D game system, games, or accessories. 

IMPORTANT Describes an action that could lead to damage to the Orion 35 
3D game system, games, or accessories. 

A WARNING The 3D Feature May Be Used Only by Children 7 and Older 

Children age 6 or younger who watch 3D images can suffer vision damage. You 
must use the Parental Control feature (see page 36) to prevent the system from 
displaying 3D images when children 6 or younger are using the system. 

A WARNING Seizures 

For a small percentage of people (approximately 1 in 4000), light flashes and 
patterns can cause seizures or blackouts. TV programs and videos can include 
these light flashes and patterns. 

Anybody who has ever had a seizure, loss of awareness, or any other symptom 
linked to epilepsy must check with a physician before playing any video game. 

Always watch your children when they play video games. Stop the game and 
consult a physician if your child has any of the following symptoms: 

• Convulsions 

• Eye or muscle twitching 

• Loss of awareness 

• Altered vision 

• Involuntary movements 

• Disorientation 

To reduce the chance that you or a child will have a seizure while playing video 
games: 

1 . Sit or stand as far as possible from the screen. 

2. Play the game on the smallest screen that is available. 

3. Do not play any video game if you are tired. 

4. Keep the room well-lit. 

5. Every hour, take a break for 10 or 1 5 minutes. 



Writing Instructions 


20 


567 


PROBLEM 

CAUSE 

CORRECTION 

The mower does 
not start. 

1 . The mower is out of gas. 

2. The gas is stale. 

3. The spark plug wire is disconnected from the 
spark plug. 

1 . Fill the gas tank. 

2. Drain the tank and refill it with fresh gas. 

3. Connect the wire to the plug. 

The mower 
loses power. 

1 . The grass is too high. 

2. The air cleaner is dirty. 

3. There is a buildup of grass, leaves, or trash 
in the underside of the mower housing. 

1 . Set the mower to a "higher cut" position. See page 1 0. 

2. Replace the air cleaner. See page 1 1 . 

3. Disconnect the spark plug wire, attach it to the retainer post, 
and clean the underside of the mower housing. See page 8. 

FIGURE 20.14 

Excerpt from a Troubleshooting Guide 



Original post from a user: 

1 am having difficulty printing TIFF files from a Microsoft program onto 11x17 sized paper to 
my WC 5335 [a Xerox printer]. When I print my file it will print only the 81/2 x 1 1 image on the 
11x17 paper. I want the image to fill up the whole 11x17 page. When I print I select fit to 
size, but I still get the same thing. Has anyone ever experienced this situation? Does anybody 
have any tips on how I can resolve this issue? Thanks. 

Reply from the Xerox representative monitoring the forum: 

Thank you for using the Support Forum. Please take a look at this solution for printing to 
11x17 sized paper and see if it relates to your issue. If this does not help please consider 
contacting your support centre for further assistance. 

Thanks. 

Response from a second user: 

Yup indeed, I agree. And I also want to share you some information about TIFF: TIFF, 
originally called Tagged Image File Format, is a computer hie format for storing images, 
including photographs, line art among graphic artists, the publishing industry, and both 
amateur and professional photographers in general. 

TIFF format is supported widely in industry image processing applications, such as 
Photoshop (Adobe), GIMP (Jasc), Photoimpact and Paint Shop Pro (Ulead) and Desktop 
publishing & Page Layout applications, like QuarkXPress and Adobe InDesign. Other 
applications, like scanning, faxing, word processing, OCR and more applications also support 
TIFF format. You can choose a TIFF processing SDK whose way of processing is simple 
and fast to process TIFF hies. I am testing with the related SDKs. I hope we can have some 
communication later. Good luck. 


Response from a third user: . 

Thanks for sharing, that's awesome but somewhat overpriced for me who wiii just use it only 
once. Do you have some cheaper or even free versions? Any suggestion will be appreciated! 

Response from a fourth user: 

I suggest you have a look at Gimp; it's open source and free. 


This excerpt from a user-support 
group on the Xerox website shows 
the way many organizations col- 
laborate with their customers to 
help solve customer problems. 

In the original post, a customer 
explains a problem he or she is 
having printing a TIFF file with a 
Xerox printer. 

The Xerox representative, who 
monitors the user forum, directs the 
customer to the company's state- 
ment that is intended to solve the 
user's problem. 

A second user recommends the 
Xerox representative's reply and 
presents additional information 
about TIFF files. Notice in the last 
sentence that he or she offers to try 
to stay in touch with the customer 
who asked the original question. 


A third user, who is experiencing 
the same problem that the first user 
wrote about, expresses appreciation 
for the second user's suggestions but 
raises a concern about the cost of the 
alternatives he or she describes. 


FIGURE 20.15 Excerpts from a Thread in a Customer-Support Forum 


Many companies use customer forums as an efficient and effective way to help their users solve problems. A fourth user responds by pointing 

Although the forums can be messy — and sometimes users write nasty things about the company — companies out that GIMP, one of the alterna- 

reatize that letting users participate greatly increases the chances that they will find solutions to their problems. tives listed by the second user, is a 

Source: Xerox Corporation, 201 3: http://forum.support.xerox.com/t5/Printing/TIFF-files/td-p/21986. Used by permission of free program. 

Xerox Corporation. 
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DOCUMENT ANALYSIS ACTIVITY 


Presenting Clear Instructions 

This page is from a set of 
instructions in an e-reader 
user's manual. The questions 
below ask you to think about 
the discussion of instructions on 
pages 551-63. 

1 . This page includes no 
graphics. Point out two or 
three passages on the page 
that might be easier to 
understand if they included 
graphics. Describe the 
graphics you would include. 

2 . Is the amount of informa- 
tion presented in each step 
appropriate? 

3 . How effectively has the 
designer used typography 
to distinguish the various 
kinds of information pre- 
sented on this page? 


Source: Barnes & Noble, Inc., 2013: http://img1.imagesbn.com/pimages/nook/nook07/mediakit/User_Guide_NOOK_HD 
_Plus_v7.pdf. Used by permission of Barnes & Noble, Inc. 


Reading on Your NOOK 

Reading a Book 

To read a book on your NOOK, tap on its cover. 

Turning Pages 

To turn to the next page, tap along the right side of the screen. You can also turn to the next page by swiping to the 
left 

To turn to the previous page, up along the left side of the screen. You can also turn to the previous page by swiping 
to the right. 

Moving from One Part of a Book to Another 

To move quickly through the book, do this: 

1 . Tap the center of the page to open the Reading Tools. 

Two panels of tools appear at the bottom of the page. 

2. Use the Reading Tools to move through the book. 

• Drag your finger along the scrollbar to scroll through the book. 

A bubble appears above the scrollbar, telling you which chapter and page you have reached. 

• To go to a specific page, up Go to Page. A dialog box appears. Type the page number you want, and 
press the Go button (an arrow). 

3. When you have reached the page you want, up the middle of the page to close the Reading Tools and continue 
reading. 

Using the Table of Contents 

To see the Table of Contents of the book, or to jump to a chapter or section listed in the Table of Contents, do this: 

1 . Tap the center of the page to open the Reading Tools. 

2. Tap the Contents icon (a suck of horizontal lines). 

A panel opens with three ubs: Table of Contents. Highlights and Notes . and Bookmarks. 

3. Tap the Table of Contents ub If it is not already highlighted. 

Your NOOK displays the Table of Contents for the book. 

4. Tap on the chapter or section you want to read next. 

Your NOOK closes the Reading Tools and displays the page you selected. 


Sames & Noble NOOK HD+ User Guide 45 
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DOCUMENT ANALYSIS ACTIVITIES 


To complete the activities below, go to "Document Analysis Activities" under "Addi- 
tional Resources" in Ch. 20 at macmillanhighered.com/launchpad/techcomm1 1 e. 


Hybrid 

3 “ ■ 



: 

&KI = 


© _ ft 

’SST" 
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t -~- 9 - ft 

Mechanism Description Using 


Interactive Graphics 

Hybrids Under the Hood (Part 2): Drivetrains, used 

by permission of the Union of Concerned Scientists. 


■? Icxr Smith 


■ HI. ■— * 



T 

Capture a Video 




■T-V • 


Instructions Using Video Screen Capture 

Courtesy TechSmith. 




N* 

. TA 




Process Description Using 
Video Animation 

Courtesy of the N.C. Department of Transportation. 



Instructions Using a Combination of Video 
Demonstration and Screen Capture 

Courtesy TexasTech University Department of 
English Media Lab. 



Instructions Using Video Demonstration 

Courtesy Eldis Group. 



Definition Using Video Animation 

Used by permission of ABC News. 


Writing Manuals 

There is no absolute distinction between a set of instructions and a 
manual. Typically, the two share a main purpose: to explain how to carry 
out a task safely, effectively, and efficiently. Both kinds of documents can 
include safety information. For example, a set of instructions on how to 
use an extension ladder explains how to avoid power lines and how to 
avoid falling off the ladder. A manual for a laptop explains how to avoid 
electrocution when you open the case. However, a set of instructions 
(which can be anywhere from 1 to 20 or more pages) is typically shorter 
than a manual and more limited in its subject. Obviously, using a laptop 
requires knowing about many more topics than does using a ladder. 
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For more about typography, see 
Ch. 1 1, p. 265. 


For more about trademarks, see 
Ch. 2, p. 26. 


For more about Simplified English, 
seeCh. 10, p.242. 


A manual likely also includes some sections not found in a set of 
instructions. For instance, it typically has a title page. The main difference 
between the two is that a manual has more-elaborate front matter and back 
matter: 

• Front matter. The introduction, sometimes called a preface, often contains 
an oueruieu; of the contents, frequently in the form of a table, which 
explains the main contents of each section and chapter. It also contains 
a conventions section, which explains the typography of the manual. For 
instance, italics are used for the titles of books, boldface for keyboard 
keys, and so forth. It also might include a where to get help section, 
referring readers to other sources of information, such as the company’s 
website and customer-support center. And it might contain a section 
listing the trademarks of the company’s own products and those of other 
companies. 

• Back matter. Manuals typically include a set of specifications of the device 
or system, a list of relevant government safety regulations and industry 
standards that the device or system supports, tips on maintenance and 
servicing the device, a copyright page listing bibliographic information about 
the manual, and an index. Many manuals also include glossaries. 

Because they typically are longer and more complex than a set of instruc- 
tions, manuals are almost always written collaboratively. Often, the writ- 
ing team uses a wiki to make it easy for various subject-matter experts to 
contribute. When the manual is finished, the writing team often uses other 
social-media tools to enable users to evaluate and comment on it or even 
contribute to future versions of it. 

Organizations work hard to make their instructions and manuals appro- 
priate for multicultural readers. Because important instructions and manuals 
might be read by readers from any number of cultures, you need to answer 
three important questions as you plan the documents: 

• In what language should the information be written? You can either 
translate the document into readers’ native languages or try to make 
the English easy to understand. Although translation is sometimes the 
best or only alternative, companies often use Simplified English or some 
other form of English with a limited grammar and vocabulary. Many 
organizations translate their manuals into various languages and post the 
translations on their websites as PDF documents for download. 

• Do the text and graphics need to be modified? As discussed in Chapter 5, 
communicators need to be aware of cultural differences. For example, one 
printer manual aimed at an Italian audience presented nude models with 
strategically placed rectangles showing the various colors the machine 
could reproduce. Nudity would be inappropriate in almost all other 
countries. A software manual in the United States showed an illustration 
of a person’s left hand. Because the left hand is considered unclean in 
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many countries in the Middle East, the manual would need to be modified 
for those countries (Delio, 2002). 

• What is the readers' technological infrastructure? If your readers don’t 
have Internet access, there is no point in making a web version of the 
information. If your readers pay by the minute for Internet access, you will 
want to create web-based information that downloads quickly. 


WRITER'S CHECKLIST 


Parenthetical, Sentence, and 
Extended Definitions 

CD Are all necessary terms defined? (p. 535) 

Are the parenthetical definitions 
CD appropriate for the audience? (p. 536) 

CD clear? (p. 536) 

CD smoothly integrated into the sentences? (p. 536) 

Does each sentence definition 

□ contain a sufficiently specific category and 
distinguishing characteristics? (p. 537) 

■ avoid describing one particular item when a general 

class of items is intended? (p. 537) 

avoid circular definition? (p. 537) 

I identify a category with a noun or a noun phrase? 

(p. 537) 

I Are the extended definitions developed logically and 

clearly? (p. 537) 

] Are the definitions placed in the location most useful to 

readers? (p. 541) 

Descriptions of Objects and Mechanisms 

I Are the nature and scope of the description clearly 
indicated? (p. 544) 

In introducing the description, did you answer, if 
appropriate, the following questions: 

] What is the item? (p. 545) 

CD What is its function? (p. 545) 

HD What does it look like? (p. 545) 


CD How does it work? (p. 545) 

I ] What are its principal parts? (p. 545) 

CD Is there a graphic identifying all the principal parts? (p. 545) 

In providing detailed information, did you 

□ answer, for each of the major components, the 
questions listed above in the section on introducing the 
description? (p. 546) 

CD choose an appropriate organizational principle? (p. 547) 
CD include graphics for each of the components? (p. 547) 

In concluding the description, did you 

□ summarize the major points in the part-by-part 
description? (p. 547) 

CD include (where appropriate) a description of the item 
performing its function? (p. 547) 

Process Descriptions 

CD Are the nature and scope of the description clearly 
indicated? (p. 544) 

In introducing the description, did you answer, if 
appropriate, the following questions: 

I What is the process? (p. 545) 

LD What is its function? (p. 545) 

CD Where and when does it take place? (p. 545) 

I Who or what performs it? (p. 545) 

CD How does it work? (p. 545) 

CD What are its principal steps? (p. 545) 

CD Is there a graphic identifying all the principal steps? 

(p. 545) 
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In providing detailed information, did you 

U answer, for each of the major steps, the questions listed 
above in the section on introducing the description? 

(p. 545) 

I discuss the steps in chronological order or some other 
logical sequence? (p. 547) 

\ I make clear the causal relationships among the steps? 

P- 547) 

EE include graphics for each of the principal steps? (p. 547) 

In concluding the description, did you 

□ summarize the major points in the step-by-step 
description? (p. 548) 

I discuss, if appropriate, the importance or implications of 

the process? (p. 548) 

Instructions 

EE In planning the instructions, did you consider other 
media, such as wikis, discussion boards, and videos? 

(P- 554) 


EH Are the instructions designed effectively, with adequate 
white space and a clear relationship between the 
graphics and the accompanying text? (p. 557) 

EE Do the instructions have a clear title? (p. 561) 

Does the introduction to the set of instructions 

□ state the purpose of the task? (p. 561) 

□ describe safety measures or other concerns that readers 
should understand? (p.561) 

EE list necessary tools and materials? (p. 561) 

Are the step-by-step instructions 
EE numbered? (p. 562) 

EE expressed in the imperative mood? (p. 562) 

EE simple and direct? (p. 562) 

□ accompanied by appropriate graphics? (p. 563) 

Does the conclusion 

EE include any necessary follow-up advice? (p. 563) 

EE include, if appropriate, a troubleshooting guide? (p. 563) 
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EXERCISES 


For more about memos, see Ch. 1 4, p. 372. 

1 . Add a parenthetical definition for the italicized term in 
each of the following sentences: 

a. Reluctantly, he decided to drop the physics course. 

b. The Anthropology Club decided to use crowdfunding 
to finance the semester's dig in Utah. 

c. The department is using shareware in its drafting 
course. 

2 . Write a sentence definition for each of the following 
terms: 

a. catalyst 

b. job interview 

c. website 

3 . Revise any of the following sentence definitions that 
need revision: 

a. A thermometer measures temperature. 

b. The spark plugs are the things that ignite the air-gas 
mixture in a cylinder. 

c. Parallel parking is where you park next to the curb. 

d. A strike is when the employees stop working. 

e. Multitasking is when you do two things at once 
while you're on the computer. 

4 . Write a 500- to 1,000-word extended definition of one 
of the following terms or of a term used in your field of 
study. In a brief note at the start, indicate the audience 
and purpose for your definition. If you do secondary 
research, cite your sources clearly and accurately (see 
Appendix, Part B, for documentation systems). Check 
that any graphics you use are appropriate for your 
audience and purpose. 

a. flextime 

b. binding arbitration 

c. robotics 

d. an academic major (don't focus on any particular 
major; instead, define what a major is) 

e. bioengineering 


5 . Write a 500- to 1 ,000-word description of one of the 
following items or of a piece of equipment used in your 
field. In a note preceding the description, specify your 
audience and indicate the type of description (general 
or particular) you are writing. Include appropriate 
graphics, and be sure to cite their sources correctly 

if you did not create them (see Appendix, Part B, for 
documentation systems). 

a. GPS device 

b. MP3 player 

c. waste electrical and electronic equipment 

d. automobile jack 

e. bluetooth technology 

6. Write a 500- to 1 ,000-word description of one of the 
following processes or a similar process with which you 
are familiar. In a note preceding the description, specify 
your audience and indicate the type of description 
(general or particular) you are writing. Include 
appropriate graphics. If you use secondary sources, cite 
them properly (see Appendix, Part B, for documentation 
systems). 

a. how a wind turbine works 

b. how a food co-op works 

c. how a suspension bridge is constructed 

d. how people see 

e. how a baseball player becomes a free agent 

7 . Study a set of instructions from Knowledge Hound: 
www.knowledgehound.com. Write a memo to your 
instructor evaluating the quality of the instructions. 
Attach a screen shot or a printout of representative 
pages from the instructions. 

8. You work in the customer-relations department of a 
company that makes plumbing supplies. The head of 
product development has just handed you a draft (see 
p. 574) of installation instructions for a sliding tub door. 
She has asked you to comment on their effectiveness. 
Write a memo to her, evaluating the instructions and 
suggesting improvements. 
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INSTALLATION INSTRUCTIONS 
CAUTION: SEE BOX NO. 1 BEFORE CUTTING ALUMINUM HEADER OR SILL 




| Measure the wall to wall opening at tub rin 
Caution: Do not forget to add 2" to inside 
tape measurement when required. 


^ Cut the bottom sill track 1/4" less than opening. 


Q Set wall jams against the wall. Align vertically, 
mark wall with pencil or crayon. 


JjjPeel backing from installation tape oi 
install by setting each jam firmly over a 
on the sill. Press firmly to the wall for a c 



Q Mount nylon rollers on top of each door panel (see sketch) using the center hole. Other holes will 
raise and lower the doors for wall alignment. Thread door panels onto header bar with smooth side 
of panels facing inside of tub. 



El If desired use a good all purpose caulk on the I 
under side of sill. Press sill down on tub ri 
drain holes face into tub. 


Q Push doors to the center of header bar. Lift 
and lower into place, easing bottom nylon doo 
guides into the propper channel of sill. 


TRIDOR MODEL ONLY: 

To reverse direction of panels, raise panels 
out of bottom track and slide catches past 
each other thereby reversing direction so 
that shower head does not throw water 
between the panels. 


HARDWARE KIT CONTENTS 
TUDOR MODEL 

4 nylon bearings 

4 ball bearing screws #8-32 x 3/8" 

TRIDOR MODEL 

6 nylon bearings 

6 ball bearing screws #8-32 x 3/8" 




9. Write a brief manual for a process familiar to you. For 
example, you might write a procedures manual for a 
school activity or a part-time job, such as your work as 
the business manager of the school newspaper or as a 
tutor in the writing center. 

10. TEAM EXERCISE Write instructions for one of the 
following activities or for a process used in your field. 

In a brief note preceding the instructions, indicate your 
audience and purpose. Include appropriate graphics. 

a. how to change a bicycle tire 

b. how to convert a WAV file to an MP3 file 


c. how to find an online discussion board and 
subscribe to it 

d. how to synchronize files and folders across two 
devices 

Exchange instructions with a partner. Each of you 
should observe the other person and take notes 
as he or she attempts to carry out the instructions. 
Then revise your instructions and share the revised 
version with your partner; discuss whether the revised 
instructions are easier to understand and apply and, if 
so, what made the difference. Submit the final version 
of your instructions to your instructor. 
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CASE 20: Choosing a Medium for Presenting Instructions 



Source: Energy Star, 

2008: http://www 
.energystar.gov/index 
.cfm?fuseaction=vid 
_gallery.showGenYTVideo. 


You work for the U.S. Department of Energy, which maintains an informational 
website called ENERGY STAR. One feature of the site is a series of videos on energy 
conservation produced for the general public. Your supervisor, concerned that few 
people are viewing most of the videos, has asked you to investigate the problem. 

Your assignment is to sample one of the videos and then do two tasks: (1) develop a 
revised script that addresses any problems you see in the original video and (2) write 
an outline for a print document that will deliver the same information. Once you've 
completed both tasks, you will need to determine what media are best for delivering 
this information to the public. To get started, go to "Cases" under "Additional Resources" 
in Ch. 20: macmillanhighered.com/launchpad/techcomm11e. 
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A RECENT SEARCH FOR "death by PowerPoint" on Google returned some 
1,41 0,000 hits. Apparently, a lot of people have been on the receiving end of 
boring presentations built around bullet slides. But an oral presentation — with or 
without slides — doesn't have to be deadly dull. 

And the process of creating and delivering a presentation doesn't have to be 
frightening. You might not have had much experience in public speaking, and 
perhaps yourfew attempts have been difficult. However, if you approach it logically, 
an oral presentation is simply another application you need to master in your role as a 
technical professional or technical communicator. Once you learn that the people in 
the room are there to hear what you have to say — not to stare at you or evaluate your 
clothing or catch you making a grammar mistake — you can calm down and deliver 
your information effectively while projecting your professionalism. 

There are four basic types of presentations: 

• Impromptu presentations. You deliver the presentation without advance 
notice. For instance, at a meeting, your supervisor calls on you to speak for a 
few minutes about a project you are working on. 

• Extemporaneous presentations. You plan and rehearse the presentation, and you 
might refer to notes or an outline, but you create the sentences as you speak. At its 
best, an extemporaneous presentation is clear and sounds spontaneous. 

• Scripted presentations. You read a text that was written out completely in 
advance (by you or someone else). You sacrifice naturalness for increased 
clarity and precision. 

• Memorized presentations. You speak without notes or a script. Memorized 
presentations are not appropriate for most technical subjects because most 
people cannot memorize presentations longer than a few minutes. 

This chapter discusses extemporaneous and scripted presentations. 

Understanding the Role of Oral Presentations 

An oral presentation has one big advantage over a written one: it enables a 
dialogue between the speaker and the audience. Listeners can make com- 
ments or ask questions, and the speaker and listeners can talk before and 
after the presentation. As a technical communicator, you can expect to give 
oral presentations to five types of audiences: 

• Clients and customers. You present the features of your products or 
services and their advantages over those of the competition. After 
concluding the sale or landing the contract, you might provide oral 
operating instructions and maintenance tips to users. 
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• Colleagues in your organization. You might instruct co-workers on a 
subject you know well. After you return from an important conference or 
an out-of-town project, you might brief your supervisors. If you have an 
idea for improving operations at your organization, you might write an 
informal proposal and then present it orally to a small group of managers. 
Your presentation helps them determine whether to study the idea. 

• Fellow professionals at technical conferences. You might speak about your 
own research project or about a team project to professionals in your field 
or in other fields. 

• Government agencies. You might speak before local, state, or federal 
government officials to explain a project your organization carried out. 

Or you might explain a proposed project so that the government officials 
can assess its implications. For instance, if you represent a developer, 
you might need to speak about the possible environmental impacts of a 
project your organization is proposing. 

• The public. You might deliver oral presentations to civic organizations and 
the general public to help these audiences understand your organization’s 
activities and plans. Oral presentations can help your organization reinforce 
its brand. 

Understanding the Process of Preparing 
and Delivering an Oral Presentation 

The Focus on Process box below presents an overview of the process of pre- 
paring and delivering an oral presentation. The rest of this chapter discusses 
this process, beginning with how to prepare a presentation. 


FOCUS ON PROCESS 


When preparing an oral presentation, pay special attention to these steps. 


PLANNING 


You will need to prepare effective presentation graphics that are 
visible, legible, simple, clear, and correct. Choose the appropriate 
technology based on the speaking situation and the available 
resources. 


DRAFTING 


Choose effective and memorable language. Your listeners will 
not be able to read your presentation to help them understand 
your message. 



Rehearse at least three times, making any necessary 
changes to your transitions, the order of your slides, or 
your graphics. 
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Preparing the Presentation 

When you see an excellent 20-minute presentation, you are seeing only 
the last 20 minutes of a process that took many hours. Experts recommend 
devoting 20 to 60 minutes of preparation time for each minute of the finished 
presentation (Nienow, 2013). That means that the average 20-minute presen- 
tation might take more than 13 hours to prepare. Obviously, there are many 
variables, including your knowledge of the subject and your experience creat- 
ing graphics and giving presentations on that subject. But the point is that 
good presentations don’t just happen. 

As you start to prepare a presentation, think about ways to enlist others to 
help you prepare and deliver it. If possible, you should rehearse the presen- 
tation in front of others. You can also call on others to help you think about 
your audience and purpose, the organization of the information, the types of 
graphics to use, appropriate designs for slides, and so forth. The more exten- 
sively you work with other people as you plan, assemble, and rehearse, the 
more successful the presentation is likely to be. 

Preparing an oral presentation requires five steps: 

• analyzing the speaking situation 

• organizing and developing the presentation 

• preparing presentation graphics 

• choosing effective language 

• rehearsing the presentation 

ANALYZING THE SPEAKING SITUATION 

First, analyze your audience and purpose. Then determine how much infor- 
mation you can deliver in the allotted time. 

Analyzing Your Audience and Purpose In planning an oral pre- 
sentation, consider audience and purpose, just as you would in writing a 
document. 

• Audience. What does the audience know about your subject? Your answer 
will help you determine the level of technical vocabulary and concepts 
you will use, as well as the types of graphics. Why are audience members 
listening to your presentation? Are they likely to be hostile, enthusiastic, 
or neutral? A presentation on the benefits of free trade, for instance, will 
be received one way by conservative economists and another way by U.S. 
steelworkers. Does your audience include nonnative speakers of English? 

If so, prepare to slow down the pace of the delivery and use simple 
vocabulary. 

• Purpose. Are you attempting to inform or to both inform and persuade? 

If you are explaining how wind-turbine farms work, you will describe a 
process. If you are explaining why your company’s wind turbines are an 
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TABLE 21.1 Time Allotment 
for a 20-Minute Presentation 


TASK 

• Introduction 


TIME (MINUTES) 


Body 

- First Major Point 

- Second Major Point 
-Third Major Point 


Conclusion 


Questions 


economical way to generate power, you will compare them 
with other power sources. 

Your analysis of your audience and purpose will affect the 
content and the form of your presentation. For example, you 
might have to emphasize some aspects of your subject and 
ignore others altogether. Or you might have to arrange topics 
to accommodate an audience’s needs. 


4 Budgeting Your Time At most professional meetings, each 

speaker is given a maximum time, such as 20 minutes. If the 
2 question-and-answer period is part of your allotted time, plan 

4 accordingly. Even for an informal presentation, you will proba- 

bly have to work within an unstated time limit that you must 
determine from the speaking situation. If you take more than 
your time, eventually your listeners will resent you or simply 
stop paying attention. 

For a 20-minute presentation, the time allotment shown in Table 21.1 is 
typical. For scripted presentations, most speakers need a little over a minute 
to deliver a double-spaced page of text effectively. 


ORGANIZING AND DEVELOPING THE 
PRESENTATION 

The speaking situation will help you decide how to organize and develop the 
For more about organizational information you will present. 

patterns, see Ch. 7. Start by considering the organizational patterns used typically in technical 

communication. One of them might fit the speaking situation. For instance, 
if you are a quality- assurance engineer for a computer-chip manufacturer 
and must address your technical colleagues on why one of the company’s 
products is experiencing a higher-than-normal failure rate, think in terms of 
cause and effect: the high failure rate is the effect, but what is the cause? Or 
think in terms of problem-method-solution: the high failure rate is the prob- 
lem; the research you conducted to determine its cause is the method; your 
recommended action is the solution. Of course, you can combine and adapt 
several organizational patterns. 

As you create an effective organizational pattern for your presentation, 
note the kinds of information you will need for each section of the presenta- 
tion. Some of this information will be data; some of it will be graphics that 
you can use in your presentation; some might be objects that you want to 
pass around in the audience. 

Some presenters like to outline their presentations on paper or in a word- 
processing document. However, more and more, people are outlining with 
their presentation software. 

As you organize your presentation, you will want to plan the introduction 
and the conclusion. 
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Planning the Introduction Like an introduction to a written document, 
an introduction to an oral presentation helps your audience understand 
what you are going to say, why you are going to say it, and how you are going 
to say it. 


In introducing a presentation, consider these five suggestions. 

► Introduce yourself. Unless you are speaking to colleagues you work with every 
day, begin with an introduction:"Good morning. My name is Omar Castillo, and 
I'm the Director of Facilities here at United." If you are using slides, include your 
name and position on the title slide. 

► State the title of your presentation. Like all titles, titles of presentations should 
name the subject and purpose, such as "Replacing the HVAC System in Building 3: 
Findings from the Feasibility Study." Include the title of your presentation on your 
title slide. 

► Explain the purpose of the presentation. This explanation can be brief: "My 
purpose today is to present the results of the feasibility study carried out by the 
Facilities Group. As you may recall, last quarter we were charged with determin- 
ing whether it would be wise to replace the HVAC system in Building 3." 

► State your main point. An explicit statement can help your audience understand 
the rest of the presentation: "Our main finding is that the HVAC system should be 
replaced as soon as possible. Replacing it would cost approximately $1 20,000. 

The payback period would be 2.5 years. We recommend that we start soliciting 
bids now, for an installation date in the third week of November." 

► Provide an advance organizer. Listeners need an advance organizer that specifi- 
cally states where you are going: "First, I'd like to describe our present system, 

highlighting the recent problems we have experienced. Next, I'd like to Then, 

I'd like to Finally, I'd like to invite your questions." 


Planning the Conclusion Like all conclusions, a conclusion to an oral 
presentation reinforces what you have said and looks to the future. 


In concluding a presentation, consider these four suggestions. 

► Announce that you are concluding. For example, "At this point, I'd like to 

conclude my talk with " This statement helps the audience focus on your 

conclusions. 


A 



Introducing the Presentation 


A 



Concluding the Presentation 


( continued ) 
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For more about creating graphics, 
seeCh. 12. 


► Summarize the main points. Because listeners cannot replay what you have 
said, you should briefly summarize your main points. If you are using slides, 
you should present a slide that lists each of your main points in one short 
phrase. 

► Look to the future. If appropriate, speak briefly about what you think (or hope) 
will happen next: "If the president accepts our recommendation, you can expect 
the renovation to begin in late November. After a few hectic weeks, we'll have the 
ability to control our environment much more precisely than we can now — and 
start to reduce our expenses and our carbon footprint." 

► Invite questions politely. You want to invite questions because they help you 
clarify what you said or communicate information that you did not present 

in the formal presentation. You want to ask politely to encourage people to 
speak up. 


PREPARING PRESENTATION GRAPHICS 

Graphics clarify or highlight important ideas or facts. Statistical data, in 
particular, lend themselves to graphical presentation, as do abstract relation- 
ships and descriptions of equipment or processes. Researchers have known 
for decades that audiences remember information better if it is presented 
to them verbally and visually rather than only verbally (see, for instance, 
Fleming and Levie, 1978). Research reported by speaking coach Terry C. Smith 
(1991) indicates that presentations that include graphics are judged more 
professional, persuasive, and credible than those that do not. In addition, 
Smith notes, audiences remember the information better: 


RETENTION AFTER 


3 HOURS 

3 DAYS 

Without graphics 

70% 

10% 

With graphics 

85% 

65% 


One other advantage of using presentation graphics is that the audience 
is not always looking at you. Giving the audience another visual focus can 
reduce your nervousness. 

Most speakers use presentation software to develop graphics. By far the 
most-popular program is PowerPoint, but other programs are becoming 
popular as well. One that has gained a lot of attention is Prezi, which takes 
a different approach from PowerPoint. Whereas PowerPoint uses a linear 
organization — the speaker presents each slide in sequence — Prezi uses a 
network or web pattern of organization. Figure 21.1 shows an example of a 
Prezi slide. 
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The free version of Prezi is cloud-based; that is, you have to be connected to the Internet to use it. This feature 
means that you can deliver your Prezi presentation from any computer with an Internet connection, that 
your team members can collaborate from remote locations, and that your presentation is stored in the cloud. 
However, your presentation is visible to all who visit the Prezi site, so you should be sure that it contains no 
confidential information or information you do not wish to share with those beyond your original audience. 



Although the speaker can present 
each slide in sequence using the 
arrows at the bottom of the screen, 
Prezi makes it simple for the speaker 
to create a new sequence each time 
he or she delivers the presentation 
or to come back to a particular slide 
or set of slides during the question- 
and-answer period. 

When the speaker clicks on any 
object on this overview slide, the 
software zooms in to reveal more 
objects within or next to that 
object. After discussing an object, 
the speaker can zoom out to the 
overview or zoom in to another 
object. 

This capability of Prezi not only 
makes it easy for the speaker to 
navigate within the presentation 
but also helps audience members 
remember the big picture because 
they see the overview graphic fre- 
quently as the speaker moves from 
point to point. Whereas PowerPoint 
is linear like a book — page 6 always 
precedes page 7 — Prezi is more 
like a website in that the speaker 
can easily jump from one object to 
another. 


FIGURE 21.1 The Network Organization of Prezi 

Reprinted by permission of the Scalability Project. 


Characteristics of an Effective Slide An effective presentation graphic 

has five characteristics: 

• It presents a clear, well-supported claim. In a presentation slide, the best 
way to present a claim and to support it is to put the claim in the headline 
section of the slide and the support in the body of the slide. Engineering 
professor and presentation specialist Michael Alley (2007) recommends 
the structure shown in Figure 21.2. 

• It is easy to see. The most common problem with presentation graphics 
is that they are too small. In general, text has to be in 24-point type or 
larger to be visible on a screen. Figure 21.3 on page 585 shows a slide that 
contains so much information that most of it is too small to see easily. 

• It is easy to read. Use clear, legible lines for drawings and diagrams; black 
on white works best. Use legible typefaces for text; a boldface sans-serif 


To watch a tutorial on 
preparing presentation slides, 
go to Ch. 21 > Additional Resources 
> Tutorials: macmillanhighered 
.com/launchpad/techcomml 1e. 


For more about typefaces, see Ch. 11, 
p. 265. For more about using color in 
graphics, see Ch. 12, p. 303. 
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Here you present the claim (in the form of a 
complete clause) that you will support with the 
graphics and words below and with the words 
you speak. 

Here you present the support for 
your claim. The support will consist 
of graphics, such as photographs, 
diagrams, and tables. Where 
appropriate, you should add brief 
clarifying comments in words. Some 
slides will include only one large 
graphic. Others will include several 
graphics. 


a. The structure of a typical slide 



Fundamental change options: 

Products and services 



Create new products and services 
consistent with USPS mission 


Develop a suite of hybrid mail products 
that integrate electronic and physical mail 


Simplify advertising products 


McKin*o6il~om|un)‘ 


b. A slide with a claim and a single large graphic 
This slide is structured like a paragraph. The words are 
the topic sentence; the graphic is the support. 

Source: McKinsey & Company, 201 0: www.usps.com 
/strategicplanning/_pdf/McKinsey_March_2nd_Presentation2.pdf. 


c. A slide with a claim, several graphics, and textual callouts 
In this slide, the headline functions as an advance organizer, 
introducing the three main options. Each option has its 
own graphic and its own key term, presented in yellow. 

Source: McKinsey & Company, 201 0: www.usps.com 
/strategicplanning/_pdf/McKinsey_March_2nd_Presentation2.pdf. 


FIGURE 21 .2 Michael Alley's Claim-and-Support Structure for Presentation Graphics 


typeface such as Arial or Helvetica is effective because it reproduces 
clearly on a screen. Avoid shadowed and outlined letters. 

• It is simple. Text and drawings must be simple. Each graphic should 

present only one idea. Your listeners have not seen the graphic before and 
will not be able to linger over it. 
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Catalogs 
9 B (6%) 


’ost cords' 


Business 

volume 


80 4 B (3%) 


Standard Mail Ad Letters 

38 B (26%) 


Flyers 

26 b (i 8 %) Ira 




s +1% or more 


First -Class 
Ad Letters 

8 B (5%) 


% 0% to -24% 


-Q- % -25% to -60% 


Sender: Consumer 
volume 


do rut itm to 1 MB pieces due to rtxndrvj 

IkE Boston Consulting Group 


FIGURE 21 .3 Too Much Information on a Slide 

Source: Boston Group, 2010: www.usps.com/strategicplanning/_pdf/BCG_Detailed presentation.pdf. 


• It is correct. Proofread your graphics carefully. Everyone makes mistakes 
in grammar, punctuation, or spelling, but mistakes are particularly 
embarrassing when they are 10 inches tall on a screen. 

When you use presentation software to create a set of graphics for a 
presentation, avoid the templates, many of which violate basic design prin- 
ciples. Instead, create a simple design. In PowerPoint, use the Slide Master 
feature. In Prezi, select “Start blank Prezi” on the “Choose your template” 
page. 

Presentation software programs contain many fancy animation effects. 
For example, you can set the software so that when a new slide appears, it is 
accompanied by the sound of applause or of breaking glass, and the head- 
ing text spins around like a pinwheel. Do not use animation effects that are 
unrelated to your subject. They undercut your professionalism and quickly 
become tiresome. 

However, one animation effect in PowerPoint, sometimes called appear 
and dim, is useful. When you create a bulleted list, you can set the software 
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to show just the first bullet item and then make the next bullet item appear 
when you click the mouse. When you do so, the previous bullet item dims. 
This feature is useful because it focuses the audience’s attention on the bul- 
let item you are discussing. 

Regardless of whether you are using the appear-and-dim feature, set 
the software so that you use the mouse (or a colleague does) to advance 
from one graphic to the next. If you set the software so that the graph- 
ics advance automatically at a specified interval, such as 60 seconds, you 
will have to speed up or slow down your presentation to keep up with the 
graphics. 

One more point: you cannot use copyrighted material — images, text, 
music, video, or other material — in your presentation without written 
permission to do so. (Your presentations in class, however, do not require 
permission because they are covered by the fair-use exemption.) 


11^ To watch a tutorial on audio 
recording and editing, go to 
Ch. 21 > Additional Resources > 
Tutorials: macmillanhighered.com 
/launchpad/techcommlle. 


Graphics and the Speaking Situation To plan your graphics, analyze 
four aspects of the speaking situation: 

• Length of the presentation. How many slides should you have? Smith 
(1991) suggests showing a different slide approximately every 30 seconds 
of the presentation. This figure is only a guideline; base your decision on 
your subject and audience. Still, the general point is valid: it is far better to 
have a series of simple slides than to have one complicated one that stays 
on the screen for five minutes. 


• Audience aptitude and experience. What kinds of graphics can your 
audience understand easily? You don’t want to present scatter graphs, for 
example, if your audience does not know how to interpret them. 

• Size and layout of the room. Graphics to be used in a small meeting room 
differ from those suitable for a 500-seat auditorium. Think first about the 
size of the images, then about the layout of the room. For instance, will a 
window create glare that you will have to consider as you plan the type or 
placement of the graphics? 

• Equipment. Find out what kind of equipment will be available in the 
presentation room. Ask about backups in case of equipment failure. If 
possible, bring your own equipment — then you can be confident that 
the equipment works and you know how to use it. Some speakers bring 
graphics in two media just in case; that is, they have slides, but they also 
have transparencies of the same graphics. If your presentation is going 
to be recorded to be made available on a website or as a podcast, try to 
arrange to have the recording technicians visit the site beforehand to see 
if there are any problems they will need to solve. 
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TECH TIP 


HowTo Create a Master Page Design 
in PowerPoint 

To create a page design of your own, you can use the Slide 
Master feature to consistently apply design elements to your 
slides. 

1. If a blank presenta- 
tion does not open 
when you launch 
PowerPoint, select 
New from the File 
tab. Next, select 
Blank Presentation, 
and then select 
Create. 

2. Select Slide Master from the Master 
Views group on the View tab. - 

By selecting elements on the master 
slide and then using the commands _ 

/on the Slide Master tab, you can 
add a background, choose a color 
scheme, and choose type styles and sizes. 



Slide Master 

H Handout Master 
ID Notes Master 


-QD 




To add graphics to the master slide, use the Images and 

Illustrations groups on the Insert tab. 



SI 

ESI 

□□ 

-HSl 

m nil 

Picture 

Clip 

Screenshot Photo 

Shapes SmartArt Chart 



Art 

• Album * 

* 



Images 

Illustrations 


To modify the format, size, or position of placeholders for 
header and footer information, right-click on the header 
or footer box on the slide, and then make a 
selection from the pop-up menu. 


\ 


, I 

\ 

Save as Picture... 

El 

Size and Position... 

a n/4/2010 


Format Shape... 

o u- 



To make changes to 
the type of 
information dis- 
played in place- 
holders, select the 
Header & Footer 
button in the Text 
group on the Insert 
tab, and then use 
the Header and 
Footer dialog box. 


3. To save your 
page design so 
that you can 
use this design 
for another 
presentation, 
select Save 
As from the 


Save as type: 

PowerPoint Presentation 

PowerPoint Presentation 
PowerPoint Macro-Enabled Presentation 
PowerPoint 97-2003 Presentation 
PDF 

XPS Document 



— ! 


Tj 


t 


File tab, and then select PowerPoint Template from the 
drop-down menu. 


KEYWORDS: slide master, presentation views, background, slide 
design, placeholder, header and footer, PowerPoint template, 
templates 
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TECH TIP 


HowTo Set List Items To Appear and 
Dim During a Presentation 

To help your audience focus on the point you are discussing, 
you can apply PowerPoint's custom animation 
feature to the Master Page so that list items appear and then 
dim when the next item appears. 

1 . To apply a custom animation, select the Title and 

Content Layout slide in the Slide Master view, and then 
highlight the list on the slide. 



2. In the Advanced 
Animation group, 
select Add Animation, 

and then select the 
Entrance category and 
the Appear effect. ► 


IV 

Add 

Animation * 

®5i) Animation Pane 

Trigger * 

^Animation Painter 

Entrance 


* 

Appear 

Fade 

n 

★ 

Wipe 

Shape 

Vt 


Zoom 

Swivel 

EmDhasis 




3. Select the Animation Pane 

button in the 

Advanced Animation 

group. In the Animation 
Pane, click the drop-down 
menu and select Effect 
Options. x 


4. On the Effect tab in the 
Appear dialog box, click 
the After Animation 
drop-down menu and 
select a dim color. 



Text ArtmaBon 




[No !ocrd] v 


DontOkn v 




More Colors... 

»s 


Qont Dim 

Hide After Ammstion 
tlidt on Meet Mouse Click 


KEYWORDS: custom animation, slide master, effect options, 
entrance effects 


Using Graphics To Signal the Organization of a Presentation 

Used effectively, graphics can help you communicate how your presen- 
tation is organized. For example, you can use the transition from one 
graphic to the next to indicate the transition from one point to the next. 
Figure 21.4 shows the slides for a presentation that accompanied the 
report in Chapter 18 on tablet computer use at Rawlings Regional Medi- 
cal Center (see p. 488). 





Selecting a Tablet Computer for the 
Clinical Staff at Rawlings Regional 
Medical Center: 

A Recommendation Report 

Prepared by: 

Jeremy Elkins, Director of IT 
Eloise Carruthers, Director of Nursing 

December 15, 2013 


The title slide shows the title of the presentation 
and the name and affiliation of each speaker. 
You might also want to include the date of the 
presentation. 


1. Introduction icontm: We cannot certify 
our tablets for disinfection 



If the images in your presentation are your own 
intellectual property or are clip art that comes 
with the software, you can legally display them 
anywhere. If they are not, you need to cite their 
sources and obtain written permission. You have 
three choices for placing the source statements: 
at the bottom of the appropriate slides, in a 
sources slide that you show at the end of the 
presentation, or on a paper handout that you 
distribute at the end of the presentation. 

Mobile Clinical Assistant: Courtesy of Panasonic 
Corporation. 


Preparing the Presentation 


21 


589 


Recommendation Report Outline 


1. Introduction 

2. Major Results 

2.1 Clinical-staff knowledge and attitudes 

2.2 8YOD v. hospital-owned model 

2.3 Determining criteria 

2.4 Assessing tablets 

3. Conclusions 

4. Recommendation 


1. Introduction: IT expenses for tablet 
maintenance are rising sharply 


$2AOCO 

$31000 

$30000 

$23000 

$20000 

Sisooo 

$10,000 

$5000 

SO 



■ 2012 

' 2013 (projactaO) 


The next slide presents an overview, which 
outlines the presentation. The arrow identifies 
the point the speaker is addressing. 

At the bottom of each slide in the body of the 
presentation is a footer with the date, the title of 
the presentation, and the number of the slide. 
The slide number gives audience members 
a way to refer to the slide when they ask 
questions. 


This slide uses a simple bar graph created in 
PowerPoint. Don't try to present a lot of informa- 
tion on a single slide. 

The title of this slide uses the numbering 
system introduced in the previous slide. This cue 
helps the audience understand the structure 
of the presentation. Following the colon is an 
independent clause that presents the claim that 
will be supported in the slide. 



For second and subsequent slides within the 
same section of the presentation, use the 
"continued" abbreviation shown here. Notice 
that the speakers use one color for the generic 
term ("Introduction") and a different color for 
the claim. 

Photo: kurhan/Shutterstock. 


Recommendation Report Outline 


1. Introduction 

2. Major Results 

2.1 Clinical-staff knowledge and attitudes 

2.2 BYOD v. hospital-owned model 

2.3 Determining criteria 

2.4 Assessing tablets 

3. Conclusions 

4. Recommendation 


This slide is identical to Slide 2, except that the 
arrow has moved. Use this organizing slide 
to help your audience remember the overall 
organization of your presentation. Don't overdo 
it; if you presented this organizing slide just a 
few slides ago, don't use it again until you make 
the transition to the next major unit in the 
presentation. 


FIGURE 21 .4 Sample PowerPoint Presentation 
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2.1 Results icoifdi: Clinical staff with tablets 
consider themselves expert users 

“I'm an expert user" 




A pie chart is a logical choice for representing a 
small number of components (usually, seven or 
fewer) that add up to 100 percent. 

Note that the speakers use conservative 
blues for all their graphics on the slide set. You 
don't need a rainbow full of colors. You need 
just enough difference so that the audience can 
distinguish between the different slices. 


Slides work best if the text is brief. The speaker 
will explain that here are the responses to the 
statement "I consider myself an expert user of 
my tablet." 





This slide was made using SmartArt graphics, 
which are part of PowerPoint. SmartArt graphics 
help you show logical relationships. Here, the 
relationship is that the hospital-supplied model 
is "heavier" — that is, has more to recommend 
it — than the BYOD model. 

The speakers added the checkmark to 
emphasize that the hospital-supplied model is 
preferable to the BYOD model. 


If the images you show are not your own intel- 
lectual property, you can legally display them in 
a college classroom because they are covered 
by the fair-use provisions of U.S. copyright law. 
However, if you display them in a business 
presentation, you would need formal written 
permission from the copyright holders. See Ch. 
2, pp. 24-26, for more information. 

Money: Bureau of Engraving and Printing. Chains on 
laptop: Elnur/Shutterstock. Mobile Clinical Assistant: 
Courtesy of Panasonic Corporation. 


FIGURE 21.4 


Sample PowerPoint Presentation ( continued ) 
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2.3 Results (corn'd): We set two desirable 
criteria for tablet study 


2.4 Results: Medical-grade tablets are too 
expensive 


2.4 Results (com'd): General-purpose tablets 
meet our data-privacy criterion 

a 


K * 

mi 

HIPAA - 

Health Inwiianc* PorraMfly 
and Accountability Act 

— 


1 

LLL 



The speakers used the “appear" animation to Money: Bureau of Engraving and Printing. Photo of HootSuite App for iPod: Courtesy of HootSuite. 

display first the picture of the tablet and then the Motion C5: Courtes >' Moti0n Compu,in 9' Verizon Wireless Samsung Galaxy Tab: PRNewsFoto/ 

' Verizon Wireless, 

picture of the battery. This feature lets the speak- 
ers display on the screen only what they are 
discussing so that the audience is not distracted 
by other images. 

TMT-1830-10 MEDICAL TABLET PC: Courtesy Teguar 
Corporation. Battery: oxanaart/Shutterstock. 


2.4 Results (com'd): General-purpose tablets 
meet our other security criteria 



2.4 Results (com'd): General-purpose tablets 
might meet our disinfection criterion 

^*0 

— ... 

E 



2.4 Results (com'd): General-purpose tablets 
might meet our durability criterion 



Chains on laptop: Elnur/Shutterstock. HootSuite App 
for iPad: Courtesy of HootSuite. Verizon Wireless Sam- 
sung Galaxy Tab: PRNewsFoto/Verizon Wireless. 


The formatting that appears throughout the 
slide set — the background color, the horizontal 
rule, and the footer — is created in the Slide- 
Master view. This formatting appears in every 
slide unless you modify or delete it for that slide. 

Note that the speakers use color — sparingly 
— for emphasis. 

Mobile Clinical Assistant: Courtesy of Panasonic 
Corporation. HootSuite App for iPad: Courtesy of 
HootSuite. Verizon Wireless Samsung Galaxy tab: 
PRNewsFoto/Verizon Wireless. 


TMT-1830-10 MEDICAL TABLET PC: Courtesy Teguar 
Corporation. HootSuite App for iPad: Courtesy of 
HootSuite. Verizon Wireless Samsung Galaxy tab: 
PRNewsFoto/Verizon Wireless. 


FIGURE 21.4 


Sample PowerPoint Presentation ( continued ) 
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2.4 Results (corn'd): General-purpose tablets 
might meet our battery criterion 



Battery: oxanaart/Shutterstock. HootSuite App for 
iPad: Courtesy of HootSuite. Verizon Wireless Samsung 
Galaxy Tab: PRNewsFoto/Verizon Wireless. 


Recommendation Report Outline 


1. Introduction 

2. Major Results 

2.1 Clinical-staff knowledge and attitudes 

2.2 BYOD v. hospital-owned model 

2.3 Determining criteria 

2.4 Assessing tablets 

3. Conclusions 

4. Recommendation 



As discussed in Ch. 18, conclusions are infer- 
ences you draw from results. 

Photo: kurhan/Shutterstock. 


3. Conclusions (cant'd): The hospital- 
supplied model is preferable to BYOD 


BYOD Hospital- 

supplied 



3. Conclusions Medical-grade tablets 
would work; general-purpose ones might 



Recommendation Report Outline 


1. Introduction 

2. Major Results 

2.1 Clinical-staff knowledge and attitudes 

2.2 BYOD v. hospital-owned model 

2.3 Determining criteria 

2.4 Assessing tablets 

3. Conclusions 

4. Recommendation 


Photo of Motion C5: Courtesy Motion Computing. 
HootSuite App for iPad: Courtesy of HootSuite. 
Verizon Wireless Samsung Galaxy Tab: PRNewsFoto/ 
Verizon Wireless. 


4. Recommendation: We recommend one 
of two options 


1. Reconsider 
budget, study 
medical-grade 
tablets. 

2. Test general- 
purpose tablets 
on-site. 


As discussed in Ch. 1 9, recommendations are 
statements about what you think should be 
done next. 

Some speakers like to make a final slide with 
the word "Questions?" on it to signal the end of 
the presentation. You can also display contact 
information (such as your email address) to 
encourage audience members to get in touch 
with you. 

Photo of Motion C5: Courtesy Motion Computing. 
HootSuite App for iPad: Courtesy of HootSuite. Verizon 
Wireless Samsung Galaxy Tab: PRNewsFoto/Verizon 
Wireless. 



FIGURE 21.4 Sample PowerPoint Presentation ( continued ) 
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Presentation software allows you to create two other kinds of documents — 
speaking notes and handouts — that can enhance a presentation. Figure 21.5 
shows a page of speaking notes. Figure 21.6 shows a page from a handout 
created from PowerPoint slides. 


To create speaking notes for each 
slide, type the notes in the box 
underthe picture of the slide, and 
then print the notes pages. You can 
print the slides on your notes pages 
in color or black and white. 

The problem with using speaking 
notes is that you cannot read your 
notes and maintain eye contact at 
the same time. 


CHOOSING EFFECTIVE LANGUAGE 

Delivering an oral presentation is more challenging than writing a document 
for two reasons: 

• Listeners can’t reread something they didn’t understand. 

• Because you are speaking live, you must maintain your listeners’ 
attention, even if they are hungry or tired or the room is too hot. 

Using language effectively helps you meet these two challenges. 


2.1 Results: Clinical staff own iPads and 
Androids 


i Apple iPad 
a Android 
Microsoft Surface 



Click to add text 


FIGURE 21.5 Speaking Notes 
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In PowerPoint, you use the Page 
Setup tab to configure the file for 
printing. You can set the software 
to display from one to nine slides 
on a page. 


Selecting a Tablet Computer for the 
Clinical Staff at Rawlings Regional 
Medical Center: 

A Recommendation Report 

P*ep»-ed by. 

•«rcTy SbU. D "erto* of & 

£ Cvruttin, D'*ecto* e f tkssfig 

Docetrbe'15.2013 


Recommendation Report Outline 


^^1. Introduction 

2. Major Results 

2.1 Cl in icai-staffkncxvledge and attitudes 

2.2 BYOD v. hospital- owned model 

2.3 Determining criteria 

2.4 Assessng tablets 

3. Conclusions 

4. Recommendation 


1. Introduction: IT expenses for tablet 
maintenance are rising sharply 


*:xc 



a >4 -vl * -«rS-rK 


1. Introduction iconwj: We cannot certify 
our tablets for disinfection 




Recommendation Report Outline 


1. Introduction 
|^2. Major Results 

2. 1 Clin ica l-staff kn ow ledge a nd attitudes 

2.2 BYOD v. hospital-owned model 

2.3 Determining criteria 

2.4 Assess ng tab lets 

3. Conclusions 

4. Recommendation 


FIGURE 21.6 Handout 

Mobile Clinical Assistant: Courtesy of Panasonic Corporation. Photo of health-care workers: kurhan/Shutterstock. 


Using Language To Signal Advance Organizers, Summaries, and 
Transitions Even if you use graphics effectively, listeners cannot “see” the 
organization of a presentation as well as readers can. For this reason, use lan- 
guage to alert your listeners to advance organizers, summaries, and transitions. 
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DOCUMENT ANALYSIS ACTIVITY 


Integrating Graphics and Text on a Presentation Slide 

The following slide is part of a presentation about the Human Genome Project. The questions below ask you to think about the discus- 
sion of preparing presentation graphics (on pp. 582-93). 



Chromosome Facts 



number of chromosomes: 

22 pairs + 1 pair 
sex-determining 
chromosomes = 46 

- one chromosome of each 
pair donated from each 
parent's egg or sperm 

- sex chromosomes: X,Y for 
males; X,X for females 

- largest chromosome: #1 = 
-263 million base pairs (bp) 

- smallest chromosome: Y = 
-59 million bp 


1 . How effective is the Human 
Genome Project logo in the 
upper left-hand corner of 
the slide? 

2 . How well does the graphic 
of DNA support the accom- 
panying text on chromo- 
some facts? 

3 . Overall, how effective is the 
presentation graphic? 


• Advance organizers. Use an advance organizer (a statement that tells the 
listener what you are about to say) in the introduction. In addition, use 
advance organizers when you introduce main ideas in the body of the 
presentation. 

• Summaries. The major summary is in the conclusion, but you might 
also summarize at strategic points in the body of the presentation. For 
instance, after a three- to four-minute discussion of a major point, you 
might summarize it in one sentence before going on to the next major 
point. Here is a sample summary from a conclusion: 

Let me conclude by summarizing my three main points about the implications 
of the new RCRA regulations on the long-range waste-management strategy for 

Radnor Township. The first point is The second point is The third point 

is I hope this presentation will give you some ideas as you think about the 

challenges of implementing the RCRA. 








MAKING ORAL PRESENTATIONS 


596 


• Transitions. As you move from one point to the next, signal the transition 
clearly. Summarize the previous point, and then announce that you are 
moving to the next point: 

It is clear, then, that the federal government has issued regulations without 
indicating how it expects county governments to comply with them. I'd like to turn 
now to my second main point 

Using Memorable Language Effective presentations require memorable 
language. 


Draw on these three techniques to help make a lasting impression on your audience. 

► Involve the audience. People are more interested in their own concerns than 
in yours. Talk to the audience about their problems and their solutions. In the 
introduction, establish a link between your topic and the audience's interests. For 
instance, a presentation to a city council about waste management might begin 
like this: 

Picture yourself on the Radnor Township Council two years from now. After 
exhaustive hearings, proposals, and feasibility studies, you still don't have a 
waste-management plan that meets federal regulations. What you do have 
is a mounting debt: the township is being fined $1,000 per day until you 
implement an acceptable plan. 

► Refer to people, not to abstractions. People remember specifics; they forget 
abstractions. To make a point memorable, describe it in human terms: 

What could you do with that $365,000 every year? In each computer lab in 
each school in the township, you could replace each laptop every three years 
instead of every four years. Or you could expand your school-lunch program 
to feed every needy child in the township. Or you could extend your after- 
school programs to cover an additional 3,000 students. 

► Use interesting facts, figures, and quotations. Search the Internet for interesting 
information about your subject. For instance, you might find a brief quotation 
from an authoritative figure in the field or a famous person not generally associ- 
ated with the field (for example, Theodore Roosevelt on waste management and 
the environment). 


A note about humor: only a few hundred people in the United States 
make a good living being funny. Don’t plan to tell a joke. If something hap- 
pens during the presentation that provides an opening for a witty remark 
and you are good at making witty remarks, fine. But don’t prepare to be funny. 


4 \ 



Using Memorable Language 
in Oral Presentations 
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REHEARSING THE PRESENTATION 

Even the most gifted speakers need to rehearse. It is a good idea to set aside 
enough time to rehearse your speech thoroughly. 

Rehearsing the Extemporaneous Presentation Rehearse your 
extemporaneous presentation at least three times. 

• First rehearsal. Don’t worry about posture or voice projection. Just deliver 
your presentation aloud with your presentation slides. Your goal is to 
see if the speech makes sense — if you can explain all the points and 
create effective transitions. If you have trouble, stop and try to figure out 
the problem. If you need more information, get it. If you need a better 
transition, create one. You are likely to learn that you need to revise the 
order of your slides. Pick up where you left off and continue the rehearsal, 
stopping again where necessary to revise. 

• Second rehearsal. This time, the presentation should flow more easily. Make 
any necessary changes to the slides. When you have complete control over 
the organization and flow, check to see if you are within the time limit. 

• Third rehearsal. After a satisfactory second rehearsal, try the presentation 
under more realistic circumstances — if possible, in front of others. The 
listeners might offer questions or constructive advice about your speaking 
style. If people aren’t available, record a video of the presentation on your 
computer or phone, and then evaluate your own delivery. If you can visit 
the site of the presentation to rehearse there, you will find giving the 
actual speech a little easier. 

Rehearse again until you are satisfied with your presentation, but don’t try to 
memorize it. 

Rehearsing the Scripted Presentation Rehearsing a scripted presentation 
is a combination of revising and editing the text and rehearsing your delivery. 

As you revise, read the script aloud to hear how it sounds. Once you think the 
presentation says what you want to say, try recording yourself with an audio or 
video recorder as you read. Revise the presentation until you are satisfied, and 
then rehearse in front of real people. Do not memorize the presentation. There is 
no need to; you will have your script in front of you on the podium. 


Delivering the Presentation 

When giving your presentation, you will concentrate on what you have to 
say. However, you will have three additional concerns: staying calm, using 
your voice effectively, and using your body effectively. 

CALMING YOUR NERVES 

Most professional actors admit to being nervous before a performance, so it 
is no wonder that most technical speakers are nervous. You might well fear 
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that you will forget everything or that no one will be able to hear you. These 
fears are common. But keep in mind three facts about nervousness: 

• You are much more aware of your nervousness than the audience is. They 
are farther away from your trembling hands. 

• Nervousness gives you energy and enthusiasm. Without energy and 
enthusiasm, your presentation will be flat. If you seem bored and listless, 
your audience will become bored and listless. 

• After a few minutes, your nervousness will pass. You will be able to relax 
and concentrate on the subject. 

This advice is unlikely to make you feel much better if you are distracted 
by nerves as you wait to give your presentation. Experienced speakers offer 
three tips for coping with nervousness: 

• Realize that you are prepared. If you have done your homework, prepared 
the presentation carefully, and rehearsed it several times, you’ll be fine. 

• Realize that the audience is there to hear you, not to judge you. Your 
listeners want to hear what you have to say. They are much less interested 
in your nervousness than you are. 

• Realize that your audience is made up of individual people who happen to 
be sitting in the same room. You’ll feel better if you realize that audience 
members are like the people you talk to every day and they also get 
nervous before making presentations. 

When it is time to begin, don’t jump up to the lectern and start speaking 
quickly. Walk up slowly and arrange your text, outline, or note cards before you. 
If water is available, take a sip. Look out at the audience for a few seconds before 
you begin. Begin with “Good morning” (or “Good afternoon” or “Good evening”), 
and refer to any officers and dignitaries present. If you have not been intro- 
duced, introduce yourself. In less-formal contexts, just begin your presentation. 

So that the audience will listen to you and have confidence in what you 
say, use your voice and your body to project an attitude of restrained self- 
confidence. Show interest in your topic and knowledge about your subject. 


4 \ 
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Releasing Nervous Energy 


Experienced speakers suggest the following four strategies for dealing with nervous- 
ness before a presentation. 


► Walk around. A brisk walk of a minute or two can calm you by dissipating some 
of your nervous energy. 

► Go off by yourself for a few minutes. Having some time alone can help you com- 
pose your thoughts and realize that you can handle your nervousness. 

► Talk with someone for a few minutes. For some speakers, distraction works best. 
Find someone to talk to. 

► Take several deep breaths, exhaling slowly. Doing so will help you control your 
nerves. 
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USING YOUR VOICE EFFECTIVELY 

Inexperienced speakers often have problems with five aspects of vocalizing. 

• Volume. Because acoustics vary greatly from room to room, you won’t 
know how well your voice will carry in a particular setting until you 
have heard someone speaking there. In some rooms, speakers can use 
a conversational volume. Other rooms require greater voice projection. 
Because more people speak too softly than too loudly, you might ask if the 
people in the back of the room can hear you. However, even soft-spoken 
people tend to speak too loudly when they speak into microphones. If you 
are using a mic, glance at your audience to see if you need to adjust your 
volume. The body language of audience members will be clear. 

• Speed. Nervousness makes people speak quickly. Even if you think you 
are speaking at the right rate, you might be going a little too fast for some 
listeners. Although you know your subject well, your listeners are trying to 
understand new information. For particularly difficult points, slow down 
for emphasis. After finishing one major point, pause before introducing 
the next one. 

• Pitch. In an effort to control their voices, many speakers end up flattening 
their pitch. The resulting monotone is boring and, for some listeners, 
distracting. Try to let the pitch of your voice go up or down as it would in a 
normal conversation. 

• Articulation. Nervousness can accentuate sloppy pronunciation. If you 
want to say environment, don’t say enuirament. A related problem occurs 
with technical words and phrases, especially the important ones. When a 
speaker uses a phrase over and over, it tends to get clipped and become 
difficult to understand. Unless you articulate carefully, Scanlon Plan will 
end up as Scanluhplah. 

• Nonfluencies. Avoid such meaningless fillers as you know, like, okay, right, 
uh, and um. These phrases do not hide the fact that you aren’t saying 
anything. A thoughtful pause is better than an annoying verbal tic. 

USING YOUR BODY EFFECTIVELY 

Besides listening to you, the audience will be looking at you. Effective speak- 
ers use their body language to help listeners follow the presentation. 




GUIDELINES 


Facing an Audience 


As you give a presentation, keep in mind these four guidelines about physical 
movement. 


► Maintain eye contact. Eye contact helps you see how the audience is receiving 
the presentation. You will see, for instance, if listeners in the back are having trou- 
ble hearing you. With small groups, look at each listener randomly; with larger 


( continued ) 
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groups, look at each segment of the audience frequently during your speech. Do 
not stare at the screen, the floor, your notes, or out the window. 

► Use natural gestures. When people talk, they often gesture with their hands. 

Most of the time, gestures make a presentation look natural and improve listen- 
ers' comprehension. You can supplement your natural gestures by using your 
arms and hands to signal pauses and to emphasize important points. When 
referring to graphics, walk toward the screen and point to direct the audience's 
attention. Avoid mannerisms — physical gestures that serve no useful purpose, 
such as jiggling the coins in your pocket or pacing back and forth. Like verbal 
mannerisms, physical mannerisms are often unconscious. Constructive criticism 
from friends can help you pinpoint them. 

► Don't block the audience's view of the screen. Stand off to the side of the screen. 
Use a pointer to indicate key words or images on the screen. 

► Control the audience's attention. People will listen to and look at anything that 
is interesting. If you hand out photocopies at the start of the presentation, some 
people will start to read them and stop listening to you. If you leave an image on 
the screen after you finish talking about it, some people will keep looking at it 
instead of listening to you. When you want the audience to look at you and listen 
to you, remove the graphics or make the screen blank. 


If your audience includes people of different cultures and native lan- 
guages, keep in mind the following three suggestions: 

• Hire translators and interpreters if necessary. If many people in the 
audience do not understand your language, hire interpreters (people who 
translate your words as you speak them) and translators (people who 
translate your written material in advance). 

• Use graphics effectively to reinforce your points for nonnative speakers. 

Try to devise ways to present information using graphics — flowcharts, 
diagrams, and so forth — to help your listeners understand you. Putting 
more textual information on graphics will allow your listeners to see as 
well as hear your points. 

• Be aware that gestures can have cultural meanings. As discussed in Chapter 
12, American hand gestures (such as the thumbs-up sign or the “okay” 
gesture) have different — and sometimes insulting — meanings in other 
cultures. Therefore, it’s a good idea to avoid the use of these gestures. You 
can’t go wrong with an arms-out, palms-up gesture that projects openness 
and inclusiveness. 


Answering Questions After a Presentation 


When you finish a presentation, thank the audience simply and directly: 
“Thank you for your attention.” Then invite questions. Don’t abruptly ask, 
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“Any questions?” This phrasing suggests that you don’t really want any 
questions. Instead, say something like this: “If you have any questions, I’ll 
be happy to try to answer them now.” If invited politely, people will be much 
more likely to ask questions, and you will be more likely to succeed in com- 
municating your information effectively. 

When you respond to questions, you might encounter any of these four 
situations: 

• You're not sure everyone heard the question. Ask if people heard it. If 
they didn’t, repeat or paraphrase it, perhaps as an introduction to your 
response: “Your question is about the efficiency of these three techniques.” 
Some speakers always repeat the question, which gives them an extra 
moment to prepare an answer. 

• You don't understand the question. Ask for clarification. After responding, 
ask if you have answered the question adequately. 

• You have already answered the question during the presentation. Restate 
the answer politely. Begin your answer with a phrase such as the 
following: “I’m sorry I didn’t make that point clear in my talk. I wanted to 
explain how . . . .” Never insult an audience member by pointing out that 
you already answered the question. 

• A belligerent member of the audience rejects your response and insists 
on restating his or her original point. Politely offer to discuss the matter 
further after the presentation. If you are lucky, the person won’t continue 
to bore or annoy the rest of the audience. 

If it is appropriate to stay after the session to talk individually with mem- 
bers of the audience, offer to do so. 


ETHICS NOTE 


ANSWERING QUESTIONS HONESTLY 

If an audience member asks a question to which you do not know the answer, admit it. Sim- 
ply say, "I don't know" or "I'm not sure, but I think the answer is . . . ." Smart people know that 
they don't know everything. If you have some ideas about how to find out the answer — by 
checking a particular reference source, for example — share them. If the question is obviously 
important to the person who asked it, you might offer to meet with him or her to discuss ways 
for you to provide a more complete response later, perhaps by email. 


Sample Evaluation Form 

Figure 21.7 is a form that can help you focus your thoughts as you watch and 
listen to presentations by your classmates. 


For a downloadable version 
of Fig. 21 .7, go to Ch. 21 > 
Additional Resources > 
Downloadable Forms: 

macmillanhighered.com 
/launchpad/techcomml 1e. 
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Oral Presentation Evaluation Form 

Speaker(s) Topic 

The left-hand column lists statements about different aspects of the presentation. In 
the middle column, rate the speaker(s) on each aspect of the presentation by writing a 
number from 1 to 6, with 1 signifying that you strongly disagree with the statement and 
6 signifying that you strongly agree with the statement. In the right-hand column, write 
any comments you wish the speaker(s) to see. 



Rating 

(1 = strongly 
disagree; 6 = 


Aspect of the Presentation 

strongly agree) 

Comments 


Organization and Development 


1. In the introduction, the 

speaker related the topic to the 
audience's concerns. 



2. In the introduction, the speaker 
explained the main points he 
or she wanted to make in the 
presentation. 



3. In the introduction, the speaker 
explained the organization of 
the presentation. 



4. 1 found it easy to understand 
the organization of the 
presentation. 



5. The speaker used appropriate 
and sufficient evidence to 
clarify the subject. 



6. In the conclusion, the speaker 
summarized the main points 
effectively. 



7. In the conclusion, the speaker 
invited questions politely. 



8. In the conclusion, the speaker 
answered questions effectively. 



9. The speaker used the allotted 
time effectively. 




Verbal and Physical Presence 


10. The speaker used interesting, 
clear language to get the points 
across. 



1 1 . The speaker used clear and 
distinct enunciation. 



1 2. The speaker seemed relaxed 
and poised. 




FIGURE 21.7 Sample Evaluation Form 
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Aspect of the Presentation 

Rating 

(1 = strongly 
disagree; 6 = 
strongly agree) 

Comments 

Verbal and Physical Presence 

1 3. The speaker exhibited no 
distracting vocal mannerisms. 



14. The speaker exhibited 
no distracting physical 
mannerisms. 



1 5. The speaker made eye contact 
effectively. 



16. The speaker was enthusiastic. 



Use of Graphics 

1 7. The speaker used graphics 
effectively to reinforce and 
explain the main points. 



18. The speaker used appropriate 
kinds of graphics. 



1 9. The speaker used graphics 
effectively to highlight 
the organization of the 
presentation. 



20. The graphics were easy to see. 



21. The graphics were easy to 
understand. 



22. The graphics looked correct 
and professional. 



23. The graphics helped me 
understand the organization 
of the presentation. 



For Group Presentations 

24. The group seemed well 
rehearsed. 



25. The graphics were edited so 
that they looked consistent 
from one group member to 
the next. 



26. The transitions from one 
group member to the next 
were smooth. 



27. Each group member seemed 
to have done an equal amount 
of work in preparing and 
delivering the presentation. 



On the other side of this sheet, answer the following two questions. 

28. What did you particularly like about this presentation? 

29. What would you have done differently if you had been the speaker? 


FIGURE 21.7 Sample Evaluation Form ( continued ) 
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SPEAKER'S CHECKLIST 


CD Did you analyze the speaking situation — the audience 
and purpose of the presentation? (p. 579) 

CD Did you determine how much information you can 
communicate in your allotted time? (p. 580) 

CD Did you choose an appropriate organizational pattern 
and determine what kinds of information to present? 
(p. 580) 

CD Did you create an outline? (p. 580) 

□ Did you plan your introduction and your conclusion? 
(p. 581) 

Does each presentation graphic have these five 
characteristics? 

CD It presents a clear, well-supported claim, (p. 583) 

□: It is easy to see. (p. 583) 

□ It is easy to read. (p. 583) 


□ It is simple, (p. 584) 

□ It is correct, (p. 585) 

I ] In planning your graphics, did you consider the length 

of your presentation, your audience's aptitude and 
experience, the size and layout of the room, and the 
equipment available? (p. 586) 

n Did you plan your graphics to help the audience 
understand the organization of your presentation? 

(p. 588) 

n Did you use language to signal advance organizers, 
summaries, and transitions? (p. 594) 

I I Did you choose language that is vivid and memorable? 

< P-596) 

I ] Did you rehearse your presentation several times with a 

tape recorder, video camera, or live audience? (p. 597) 


EXERCISES 


1 . Learn some of the basic functions of a presentation 
software program. For instance, modify a template, 
create your own original design, add footer information 
to a master slide, insert a graphic on a slide, and set the 
animation feature to make just the first bullet item on a 
slide appear and then show the next bullet item after a 
mouse click. 

2. Using PowerPoint, create a design to be used for the 
master slide for a presentation to be delivered in one 
of your classes. If you are unfamiliar with how to create 
a master slide, consult PowerPoint's help files. Be 
prepared to explain the design to your classmates. 

3. Prepare a five-minute presentation, including graphics, 
on one of the topics listed below. The audience for your 
presentation will consist of the other students in your 
class, and your purpose will be to introduce them to an 
aspect of your academic field. 


a. Define a key term or concept in your field. 

b. Describe how a particular device or technology is 
used in your field. 

c. Describe how to carry out a procedure common in 
your field. 

Your instructor and the other students will evaluate the 
presentation by filling out the form in Figure 21 .7. 

4. TEAM EXERCISE Prepare a five-minute presentation 
based either on the proposal for a research project that 
you prepared in Chapter 1 6 or on your recommendation 
report for that project. Your audience will consist of the 
other students in your class, and your purpose will be 
to introduce them to your topic. The instructor and the 
other students will evaluate your presentation by filling 
out the form in Figure 21.7. Your instructor might have 
you work on this assignment collaboratively. 


CASE 21 : Understanding the Claim-and-Support Structure for Presentation Graphics 



You have been invited to a student conference to make an oral presentation of a paper you 
wrote for a class. Because you do not have much experience delivering presentations, you 
run a few ideas by a friend, who offers great pointers. She's offered to look at your revised 
slides, so you need to get to work creating the slides and determining the best organization 
scheme for them. To get started on your presentation, go to "Cases" under "Additional 
Resources"in Ch. 21: macmillanhighered.com/launchpad/techcomm11e. 
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LEARNINGCURVE: Articles and Nouns for Multilingual Writers S3 
LEARNINGCURVE: Prepositions for Multilingual Writers B 
LEARNINGCURVE: Sentence Structure for Multilingual Writers 
LEARNINGCURVE: Verbs for Multilingual Writers S3 


Part A: Skimming Your 
Sources and Taking Notes 

To record the information that will eventually go into your document, you 
need to skim your potential sources and take notes. Don’t try to read every 
potential source. A careful reading of a work that looks promising might 
prove disappointing. You might also get halfway through a book and realize 
that you must start writing immediately in order to submit your document 
on time. 
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Skimming Books and Articles 


To skim effectively, look at the following parts of books and articles. 


In a book, skim 

► the preface and introduction: to 

understand the writer's approach 
and methods 

► the acknowledgments section: to 

learn about help the author received 
from other experts in the field or 
about the author's use of primary 
research or other resources 

► the table of contents: to understand 
the book's scope and organization 

► the notes at the ends of chapters or 
at the end of the book: to under- 
stand the nature and extent of the 
author's research 

► the index: to determine the extent of 
the coverage of the information you 
need 

► a few paragraphs from different 
portions of the text: to gauge 
the quality and relevance of the 
information 


In an article, skim 

► the abstract: to get an overview of 
the article's content 

► the introduction: to understand the 
article's purpose, main ideas, and 
organization 

► the notes and references: to under- 
stand the nature and extent of the 
author's research 

► the headings and several of the 
paragraphs: to understand the 
article's organization and the quality 
and relevance of the information 
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Skimming will not always tell you whether a book or article is going to 
be useful, but it can tell you if a work is not going to be useful — because it 
doesn’t cover your subject, for example, or because it is too superficial or too 
advanced. Eliminating the sources you don’t need will give you more time to 
spend on the ones you do. 

Note taking is often the first step in writing a document. The best way 
to take notes is electronically. If you can download files from the Internet, 
download bibliographic references from a CD-ROM database, and take notes 
on a laptop, you will save a lot of time and prevent many errors. If you do not 
have access to these electronic tools, get a pack of note cards. 

Most note taking involves three kinds of activities: paraphrasing, quot- 
ing, and summarizing. Knowing how to paraphrase, quote, and summarize is 
important for two reasons: 

• To a large extent, your note taking will determine the quality of your 
finished product. You want to record information accurately and clearly. 

Mistakes made at this point can be hard to catch later, and they can ruin 
your document. 

• You want to use your sources responsibly. You don’t want to plagiarize For a discussion of plagiarism, see 

unintentionally. Appendix, Part B, p.614. 
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Recording Bibliographic Information 


Record the bibliographic information for each source from which you take notes. 


Information to record for a book 


Information to record for an article 


► author 


► author 


► title 


► title of article 


► publisher 


► title of periodical 


► place of publication 

► year of publication 

► call number or URL 


► volume 


► number 


► date of publication 

► pages on which article appears 

► call number or URL of periodical 


For electronic sources, record any additional relevant information such as identify- 
ing numbers, database name, and retrieval data. 


Paraphrasing 


A paraphrase is a restatement, in your own words, of someone else’s words. If 
you simply copy someone else’s words — even a mere two or three in a row — 
you must use quotation marks. 
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In taking notes, what kind of material should you paraphrase? Any infor- 
mation that you think might be useful: background data, descriptions of 
mechanisms or processes, test results, and so forth. 

Figure A.l shows a paraphrased passage based on the following discus- 
sion. The author is explaining the concept of performance-centered design. 

Original Passage 

In performance-centered design, the emphasis is on providing support for the 
structure of the work as well as the information needed to accomplish it. One of 
the best examples isTurboTax®, which meets all the three main criteria of effective 
performance-centered design: 

• People can do their work with no training on how to use the system. People trying to 
do their income taxes have no interest in taking any kind of training. They want 
to get their taxes filled out correctly and quickly, getting all the deductions they 
are entitled to. These packages, over the years, have moved the interface from 
a forms-based one, where the user had to know what forms were needed, to an 
interview-based one that fills out the forms automatically as you answer questions. 
The design of the interface assumes no particular computer expertise. 


This paraphrase is inappropriate 
because the three bulleted points 
are taken word for word from the 
original. The fact that the student 
omitted the explanations from 
the original is irrelevant. These are 
direct quotes, not paraphrases. 


Lovgren, "Achieving Performance-Centered Design" 
www.reisman-consulting.com/pages/a-Perform.html 

example of performance-centered design: 

TurboTax® meets three main criteria: 

• People can do their work with no training on how to use the system. 

• The system provides the right information at the right time to accomplish the 
work. 

• Both tasks and systems change as the user understands the system. 


a. Inappropriate paraphrase 


This paraphrase is appropriate be- 
cause the words are different from 
those used in the original. 

When you turn your notes into a 
document, you are likely to reword 
your paraphrases. As you revise 
your document, check a copy of 
the original source document to be 
sure you haven't unintentionally 
reverted to the wording from the 
original source. 


Lovgren, "Achieving Performance-Centered Design" 
www.reisman-consulting.com/pages/a-Perform.html 

example of performance-centered design: 

TurboTax* meets three main criteria: 

• You don't have to learn how to use the system. 

• The system knows how to respond at the appropriate time to what the user is doing. 

• As the user gets smarter about using the system, the system gets smarter, making it 
faster to complete the task. 


b. Appropriate paraphrase 

FIGURE A.l Inappropriate and Appropriate Paraphrased Notes 

Source: Adapted from Lovgren, 2000: www.reisman-consulting.com/pages/a-Perform.html. 
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• The system provides the right information at the right time to accomplish the work. At 
each step in the process, the system asks only those questions that are relevant 
based on previous answers. The taxpayer is free to ask for more detail or may 
proceed through a dialog that asks more-detailed questions if the taxpayer doesn't 
know the answer to the higher-level question. If a taxpayer is married filing jointly, 
the system presents only those questions for that filing status. 

• Both tasks and systems change as the user understands the system. When I first used 
TurboTax 6 years ago I found myself going to the forms themselves. Doing my 
taxes generally took about 2 days. Each year I found my need to go to the forms to 
be less and less. Last year, it took me about 2 hours to do my taxes, and I looked at 
the forms only when I printed out the final copy. 


A 
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Paraphrasing Accurately 


► Study the original until you understand it thoroughly. 

► Rewrite the relevant portions of the original. Use complete sentences, frag- 
ments, or lists, but don't compress the material so much that you'll have trouble 
understanding it later. 

► Title the information so that you'll be able to identify its subject at a glance. The 

title should include the general subject and the author's attitude or approach to 
it, such as "Criticism of open-sea pollution-control devices." 

► Include the author's last name, a short title of the article or book, and the page 
number (if any) of the original. You will need this information later in citing your 
source. 


Quoting 

Sometimes you will want to quote a source, either to preserve the author’s 
particularly well-expressed or emphatic phrasing or to lend authority to your 
discussion. Avoid quoting passages of more than two or three sentences, or 
your document will look like a mere compilation. Your job is to integrate an 
author’s words and ideas into your own thinking, not merely to introduce a 
series of quotations. 

Although you probably won’t be quoting long passages in your document, 
recording a complete quotation in your notes will help you recall its meaning 
and context more accurately when you are ready to integrate it into your own 
work. 

The simplest form of quotation is an author’s exact statement: 

As Jones states, "Solar energy won't make much of a difference for at least a decade." 

To add an explanatory word or phrase to a quotation, use brackets: 

As Nelson states, "It [the oil glut] will disappear before we understand it." 


For more about formatting 
quotations, see "Quotation Marks," 
"Ellipses," and "Square Brackets" in 
Appendix, Part C. For a discussion 
of howto document quotations, see 
Appendix, Part B. 
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Use ellipses (three spaced dots) to show that you are omitting part of an 
author’s statement: 

original statement "The generator, which we purchased in May, has turned out 
to be one of our wisest investments." 

elliptical quotation "The generator . . . has turned out to be one of our wisest 

investments." 

According to the documentation style recommended by the Modern Lan- 
guage Association (MLA), if the author’s original statement has ellipses, you 
should add brackets around the ellipses that you introduce: 

original statement "I think reuse adoption offers . . . the promise to improve 
business in a number of ways." 

elliptical quotation "I think reuse adoption offers . . . the promise to improve 

business [. . .] ." 


Summarizing 

Summarizing is the process of rewriting a passage in your own words to 
make it shorter while still retaining its essential message. Writers summarize 
to help them learn a body of information or to create a draft of one or more 
of the summaries that will go into the document. 

Most long technical documents contain several kinds of summaries: 

• a letter of transmittal (see page 479) that provides an overview of the 
document 

• an abstract (see page 479), a brief technical summary 

• an executive summary (see page 483), a brief nontechnical summary 
directed to the manager 

• a conclusion (see page 478) that draws together a complicated discussion 
The guidelines and examples in this section explain how to summarize the 
printed information you uncover in your research. 


4 \ 


GUIDELINES 


Summarizing 


The following advice focuses on extracting the essence of a passage by summariz- 
ing it. 


► Read the passage carefully several times. 


► Underline key ideas. Look for them in the titles, headings, topic sentences, transi- 
tional paragraphs, and concluding paragraphs. 


( continued ) 
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► Combine key ideas. Study what you have underlined. Paraphrase the underlined 
ideas. Don't worry about your grammar, punctuation, or style at this point. 

► Check your draft against the original for accuracy and emphasis. Check that 
you have recorded statistics and names correctly and that your version of a 
complicated concept faithfully represents the original. Check that you got the 
proportions right; if the original devotes 20 percent of its space to a particular 
point, your draft should not devote 5 percent or 50 percent to that point. 

► Record the bibliographic information carefully. Even though a summary might 
contain all your own words, you still must cite your source, because the main 
ideas are someone else's. If you don't have the bibliographic information in an 
electronic form, put it on a note card. 


Figure A.2 is a narrative history of television technology addressed to the 
general reader. Figure A.3 on page 613 is a summary that includes the key 
terms. This summary is 10 percent of the length of the original. 


A BRIEF HISTORY OF TELEVISION 

Although it seems as if television has been around for a long time, it's a relatively 
new science, younger than rocketry, internal medicine, and nuclear physics. In fact, 
some of the people that helped develop the first commercial TV sets and erect the 
first TV broadcast antennas are still living today. 

The Early Years 

The first electronic transmission of a picture was believed to have been made by a 
Scotsman, John Logie Baird, in the cold month of February 1 924. His subject was 
a Maltese Cross, transmitted through the air by the magic of television (also called 
"Televisor" or "Radiovision" in those days) the entire distance of ten feet. 

To say that Baird's contraption was crude is an understatement. His Televisor was 
made from a cardboard scanning disk, some darning needles, a few discarded 
electric motors, piano wire, glue, and other assorted odds and ends. The picture 
reproduced by the original Baird Televisor was extremely difficult to see — a 
shadow, at best. 

Until about 1 928, other amateur radiovision enthusiasts toyed around with Baird's 
basic design, whiling away long hours in the basement transmitting Maltese 
Crosses, model airplanes, flags, and anything else that would stay still long enough 
under the intense light required to produce an image. (As an interesting aside, the 
lighting for Baird's 1 924 Maltese Cross transmission required 2,000 volts of power, 
produced by a roomful of batteries. So much heat was generated by the lighting 
equipment that Baird eventually burned his laboratory down.) 

Baird's electromechanical approach to television led the way to future 
developments in transmitting and receiving pictures. The nature of the Baird 
Televisor, however, limited the clarity and stability of images. Most of the sets made 
and sold in those days required the viewer to peer through a glass lens to watch 
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Original Passage 

Source: Based on McComb, 1991. 
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the screen, which was seldom over seven by ten inches in size. What's more, the 
majority of screens had an annoying orange glow that often marred reception and 
irritated the eyes. 

Modern Television Technology 

In the early 1 930s, Vladimir Zworykin developed a device known as the iconoscope 
camera. About the same time, Philo T. Farnsworth was putting the finishing touches 
on the image dissector tube, a gizmo that proved to be the forerunner of the modern 
cathode ray tube or CRT — the everyday picture tube. These two devices paved the 
way for the TV sets we know and cherish today. 

The first commercially available modern-day cathode ray tube televisions were 
available in about 1 936. Tens of thousands of these sets were sold throughout 
the United States and Great Britain, even though there were no regular television 
broadcasts until 1 939, when RCA started what was to become the first American 
television network, NBC. Incidentally, the first true network transmission was in 
early 1940, between NBC's sister stations WNBT in New York City (now WNBC-TV) 
and WRGB in Schenectady. 

Postwar Growth 

World War II greatly hampered the development of television, and during 
1941-1 945, no television sets were commercially produced (engineers were too 
busy perfecting radar, which, interestingly enough, contributed significantly to 
the development of conventional TV). But after the war, the television industry 
boomed. Television sets were selling like hotcakes, even though they cost an 
average of $650 (based on average wage earnings, that's equivalent to about 
$4,000 today). 

Progress took a giant step in 1 948 and 1 949 when the four American networks, NBC, 
CBS, ABC, and Dumont, introduced quality, "class-act" programming, which at the 
time included Kraft Television Theatre, Howdy Doody, and The Texaco Star Theatre with 
Milton Berle. These famous stars of the stage and radio made people want to own a 
television set. 

Color and Beyond 

Since the late 1 940s, television technology has continued to improve and mature. 
Color came on December 1 7, 1 953, when the FCC approved RCA's all-electronic 
system, thus ending a bitter, four-year bout between CBS and RCA over color 
transmission standards. Television images beamed via space satellite caught the 
public's fancy in July of 1 962, when Telstar 1 relayed images of AT&T chairman 
Frederick R. Kappell from the U.S. to Great Britain. Pay-TV came and went several 
times in the 1 950s, 1 960s, and 1 970s; modern-day professional commercial videotape 
machines were demonstrated in 1 956 by Ampex; and home video recorders had 
appeared on retail shelves by early 1 976. 


FIGURE A.2 Original Passage (continued) 
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Summary: A Brief History of Television 

In 1 924, Baird made the first electronic transmission of a picture. The primitive 
equipment produced only a shadow. Although Baird's design was modified 
by others in the 1 920s, the viewer had to look through a glass lens at a small 
screen that gave off an orange glow. 

Zworykin's iconoscopic camera and Farnsworth's image dissector 
tube — similar to the modern CRT — led in 1936 to the development of 
modern TV. Regular broadcasts began in 1 939 on the first network, NBC. 
Research stopped during WWII, but after that, sales grew, even though sets 
cost approximately $650, the equivalent of $4,000 today. 

Color broadcasts began in 1953; satellite broadcasting began in 1 962; and 
home VCRs were introduced in 1 976. 

Key terms: television, history of television, NBC, color television, satellite 
broadcasting, videocassette recorders, Baird, Zworykin, Farnsworth. 
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For more about quoting and 
paraphrasing sources, see Appendix, 
Part A. 


For more about using graphics from 
other sources, see Ch. 12, p. 301. 


Part B: Documenting Your Sources 

Documentation identifies the sources of the ideas and the quotations in your 
document. Documentation consists of the citations in the text throughout 
your document and the reference list (or list of works cited) at the end of 
your document. Documentation serves three basic functions: 

• It helps you acknowledge your debt to your sources. Complete and accurate 
documentation is a professional obligation, a matter of ethics. Failure to 
document a source, whether intentional or unintentional, is plagiarism. 

At most colleges and universities, plagiarism can mean automatic failure 
of the course and, in some instances, suspension or expulsion. In many 
companies, it is grounds for immediate dismissal. 

• It helps you establish credibility. Effective documentation helps you place 
your document within the general context of continuing research and 
helps you define it as a responsible contribution to knowledge in the field. 
Knowing how to use existing research is one mark of a professional. 

• It helps your readers find your source in case they want to read more about a 
particular subject. 

Three kinds of material should always be documented: 

• Any quotation from a written source or an interview, even if it is only a few 
words. 

• A paraphrased idea, concept, or opinion gathered from your reading. There 
is one exception. An idea or concept so well known that it has become 
general knowledge, such as Einstein’s theory of relativity, needs no 
citation. If you are unsure about whether an item is general knowledge, 
document it, just to be safe. 

• Any graphic from a written or an electronic source. Cite the source for a 
graphic next to the graphic or in the reference list. For an online source, 
be sure to include a retrieval statement, URL, or DOI in the bibliographic 
entry. If you are publishing your work, you must also obtain permission to 
use any graphic protected by copyright. 

Just as organizations have their own rules for formatting and punctuation, 
many organizations also have their own documentation styles. For docu- 
ments prepared in the workplace, find out your organization’s style and abide 
by it. Check with your instructor to see which documentation system to use 
in the documents you write for class. The documentation systems included 
in this section of the appendix are based on the following style manuals: 

• Publication manual of the American Psychological Association (6th ed.). (2010). 
Washington, DC: APA. This system, referred to as APA style, is used widely 
in the social sciences. 

• IEEE editorial style manual [PDF], (2014). Piscataway, NJ: IEEE. This manual 
provides editorial guidelines for IEEE Transactions, Journals, and 


Part B: Documenting Your Sources 


Letters, but it is often used for the production of technical documents 
in areas ranging from computer engineering, biomedical technology, 
and telecommunications to electric power, aerospace, and consumer 
electronics. 

• MLA handbookfor writers of research papers (7th ed.). (2009). New York: 
Modern Language Association. This system, referred to as MLA style, is 
used widely in the humanities. 

Other organizations may prefer one of the following published style guides. 

GENERAL 

University of Chicago. Chicago manual of style (16th ed.). (2010). Chicago, IL: 
Author. See also http://www.chicagomanualofstyle.org/home.html 

BUSINESS 

American Management Association. (2009). The AMA style guide for business 
writing. New York, NY: AMACOM. See also http://www.amanet.org 

CHEMISTRY 

American Chemical Society. (2006). ACS style guide: A manual for authors and 
editors (2nd ed.). Washington, DC: Author. See also http://www.acs.org 

GEOLOGY 

Adkins-Heljeson, M., Bates, R. L., & Buchanan, R. (Eds.). (1995). Geowriting: A 
guide to writing, editing, and printing in earth science (5th rev. ed.). Alexandria, 
VA: American Geological Institute. See also http://www.agiweb.org 

GOVERNMENT DOCUMENTS 

U.S. Government Printing Office. (2008). Style manual (30th ed.). Washington, 
DC: Author. See also http://www.gpo.gov 

JOURNALISM 

Christian, D., Jacobsen, S., & Minthorn, J. (Eds.). (2013). Associated Press 

styleboofe 2013. New York, NY: Associated Press. See also http://www.ap.org 

LAW 

Columbia Law Review, Harvard Law Review, University of Pennsylvania Law 
Review, and Yale Law Journal. (2010). The bluebook: A uniform system of 
citation (19th ed.). Cambridge, MA: Harvard Law Review Association. See 
also http://www.legalbluebook.com 

MATHEMATICS 

Higham, N. J. (1998). Handbook of writing for the mathematical sciences (2nd ed.). 
Philadelphia, PA: Society for Industrial and Applied Mathematics. See also 
http://www.siam.org 

MEDICINE 

American Medical Association. (2007). American Medical Association manual 
of style (10th ed.). New York, NY: Oxford University Press. See also http:// 
www.amamanualofstyle.com 
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NATURAL SCIENCES 

Council of Science Editors. Scientific style and format: The CSE manual for 

authors, editors, and publishers (7th ed.). New York, NY: Cambridge University 
Press. See also http://www.councilscienceeditors.org 

PHYSICS 

American Institute of Physics, Publication Board. (1990). Style manual for 
guidance in the preparation of papers (4th ed.). New York, NY: Author. See also 
http ://ww w. aip.org 

POLITICAL SCIENCE 

American Political Science Association. (2006). Style manual for political science 
(rev. ed.). Washington, DC: Author. See also http://www.apsanet.org 

SCIENCE AND TECHNICAL WRITING 

National Information Standards Organization. (2005). Scientific and technical 
reports — Preparation, presentation and preservation. Bethesda, MD: Author. See 
also http://www.niso.org 

Rubens, P. (Ed.). (2000). Science and technical writing: A manual of style (2nd ed.). 
New York, NY: Routledge. 

SOCIAL WORK 

National Association of Social Workers. (1995). Writing for the NASW Press: 
Information for authors (rev. ed.). Washington, DC: Author. See also http:// 
www.naswpress.org 

SOCIOLOGY 

American Sociological Association. (2007). American Sociological Association 
style guide (3rd ed.). Washington, DC: Author. See also http://www.asanet 
■org 

APA Style 

APA (American Psychological Association) style consists of two elements: 

citations in the text and a list of references at the end of the document. 


APA Style for Textual Citations 


1. Summarized or Paraphrased 
Material 618 

2. Quoted Material or Specific Fact 61 8 

3. Source with Multiple Authors 618 

4. Source Authored by an 
Organization 618 

5. Source with an Unknown 
Author 619 


6. Multiple Authors with the Same Last 
Name 619 

7. Multiple Sources in One Citation 619 

8. Personal Communication 619 

9. Electronic Document 619 
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APA Style for Reference List Entries 


BOOKS 

1 0. Book by One Author 621 

1 1 . Book by Multiple Authors 621 

12. Multiple Books by the Same 
Author 621 

13. Book Authored by an 
Organization 621 

14. Book by an Unknown Author 623 

15. Edited Book 623 

1 6. Chapter or Section in an Edited 
Book 623 

1 7. Book in an Edition Other Than the 
First 623 

18. Multivolume Work 623 

1 9. Translated Book 623 

20. Non-English Book 623 

21 . Entry in a Reference Work 623 

PERIODICALS 

22. Journal Article 623 

23. Magazine Article 625 

24. Newspaper Article 625 

25. Newsletter Article 625 

ELECTRONIC SOURCES 

26. Nonperiodical Web Document 625 

Journal Articles 

27. Article with DOI Assigned 625 

28. Article with No DOI Assigned 627 

29. Preprint Version of Article 627 

Electronic Books 

30. Entire Book 627 

Dissertations and Theses 

31. Dissertation Retrieved from 
Database 627 

Reference Materials 

32. Online Encyclopedia 627 

33. Online Dictionary 627 

34. Wiki 627 


Raw Data 

35. Data Set 627 

36. Graphic Representation of Data 627 

37. Qualitative Data 629 

Other Electronic Documents 

38. Technical or Research Report 629 

39. Presentation Slides 629 

General-Interest Media and Alternative 
Presses 

40. Newspaper Article 629 

41 . Audio Podcast 629 

42. Online Magazine Content Not Found in 
Print Version 629 

Online Communities 

43. Message Posted to an Electronic 
Mailing List, Online Forum, or 
Discussion Group 629 

44. Blog Post 630 

45. Email Message or Real-Time 
Communication 630 

OTHER SOURCES 

46. Technical or Research Report 630 

47. Government Document 630 

48. Brochure or Pamphlet 630 

49. Article from Conference 
Proceedings 630 

50. Lecture or Speech 631 

51 . Audio Recording 631 

52. Motion Picture 631 

53. Television Program 631 

54. Published Interview 631 

55. Personal Interview 631 

56. Personal Correspondence 631 

57. Unpublished Data 632 
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APA TEXTUAL CITATIONS 

In APA style, a textual citation typically includes the name of the source’s 
author and the date of its publication. Textual citations vary depending on 
the type of information cited, the number of authors, and the context of the 
citation. The following models illustrate a variety of common textual cita- 
tions; for additional examples, consult the Publication Manual of the American 
Psychological Association. 

1 . Summarized or Paraphrased Material For material or ideas that you have 
summarized or paraphrased, include the author’s name and the publication 
date in parentheses immediately following the borrowed information. 

This phenomenon was identified more than 50 years ago (Wilkinson, 1 948). 

If your sentence already includes the source’s name, do not repeat it in the 
parenthetical notation. 

Wilkinson (1 948) identified this phenomenon more than 50 years ago. 

2. Quoted Material or Specific Fact If the reference is to a specific fact, idea, or 
quotation, add the page number(s) from the source to your citation. 

This phenomenon was identified more than 50 years ago (Wilkinson, 1 948, p. 36). 

Wilkinson (1 948) identified this phenomenon more than 50 years ago (p. 36). 

3. Source with Multiple Authors For a source written by two authors, cite both 
names. Use an ampersand (&) in the parenthetical citation itself, but use the 
word and in regular text. 

(Tyshenko & Paterson, 2012) 

Tyshenko and Paterson (201 2) argued . . . 

For a source written by three, four, or five authors, include all the names the 
first time you cite the reference; after that, include only the last name of the 
first author followed by et a l. 

First Text Citation 

Cashman, Walls, and Thomas (201 3) argued . . . 

Subsequent Citations 

Cashman et al. (2013) found . . . 

For a source written by six or more authors, use only the first author’s name 
followed by et al. 

(Marken et at, 2014) 

Marken et al. (2014) reported . . . 

4. Source Authored by an Organization If the author is an organization rather 
than a person, use the name of the organization. 

There is currently ongoing discussion of the scope and practice of nursing informatics 
(American Nurses Association, 2010). 
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In a recent publication, the American Nurses Association (2010) discusses the scope 
and practice of nursing informatics. 

If the organization name is commonly abbreviated, you may include the 
abbreviation in the first citation and use it in any subsequent citations. 

First Text Citation 

(International Business Machines [IBM], 201 1) 

Subsequent Citations 

(IBM, 2011) 

5. Source with an Unknown Author If the source does not identify an author, 
use a shortened version of the title in your parenthetical citation. 

Hawking made the discovery that under precise conditions, thermal radiation could 
exit black holes ("World Scientists," 2009). 

If the author is identified as anonymous — a rare occurrence — treat Anony- 
mous as a real name. 

(Anonymous, 201 1) 

6. Multiple Authors with the Same Last Name Use first initials if two or more 
sources have authors with the same last name. 

B. Porter (2012) created a more stable platform for database transfers, while A. L. 

Porter (2012) focused primarily on latitudinal peer-to-peer outcome interference. 

7. Multiple Sources in One Citation When you refer to two or more sources in 
one citation, present the sources in alphabetical order, separated by a semicolon. 

This phenomenon has been well documented (Houlding, 2011; Jessen, 2010). 

8. Personal Communication When you cite personal interviews, phone calls, 
letters, memos, and emails, include the words personal communication and the 
date of the communication. 

D. E. Walls (personal communication, April 3, 201 1) provided the prior history of his . . . 

9. Electronic Document Cite the author and date for an electronic source 
as you would for other kinds of documents. If the author is unknown, give 
a shortened version of the title in your parenthetical citation. If the date is 
unknown, use n.d. (for no date). 

Interpersonal relationships are complicated by differing goals (Hoffman, n.d.). 

If the document is posted as a PDF file, include the page number in the cita- 
tion. If a page number is not available but the source contains paragraph 
numbers, give the paragraph number. 

(Tong, 2010, para. 4) 

If no paragraph or page number is available and the source has headings, cite 
the appropriate heading and paragraph. 

The CDC (2007) warns that babies born to women who smoke during pregnancy are 
30% more likely to be born prematurely (The Reality section, para. 3). 
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For a sample APA-style reference list, 
see p. 632. 


THE APA REFERENCE LIST 

A reference list provides the information your readers will need in order to 

find each source you have cited in the text. It should not include sources you 

read but did not use. 

Following are some guidelines for an APA-style reference list. 

• Arranging entries. Arrange the entries alphabetically by author’s last 
name. If two or more works are by the same author, arrange them by date, 
earliest to latest. If two or more works are by the same author in the same 
year, list them alphabetically by title and include a lowercase letter after 
the date: 2010a, 2010b, and so on. Alphabetize works by an organization by 
the first significant word in the name of the organization. 

• Book titles. Italicize titles of books. Capitalize only the first word of the 
book’s title, the first word of the subtitle, and any proper nouns. 

• Publication information. For books, give the publisher’s name in as brief 
a form as is intelligible; retain the words Books and Press. Include the 
name of both the city and the state (abbreviated) for publishers located in 
U.S. cities or the city and the country (not abbreviated) for publishers in 
non-U.S. cities; for publishers located in Canadian cities, also include the 
province. 

• Periodical titles. Italicize titles of periodicals and capitalize all major words. 

• Article titles. Do not italicize titles of articles or place them in quotation 
marks. Capitalize only the first word of the article’s title and subtitle and 
any proper nouns. 

• Electronic sources. Include as much information as you can about 
electronic sources, such as author, date of publication, identifying 
numbers, and retrieval information. Include the digital object identifier 
(DOI) when one exists. Remember that electronic information changes 
frequently. If the content of an electronic source is likely to change, be 
sure to record the date you retrieved the information. 

• Indenting. Use a hanging indent, with the first line of each entry flush with 
the left margin and all subsequent lines indented one-half inch: 

Sokolova, G. N. (2010). Economic stratification in Belarus and Russia: An experiment 
in comparative analysis. Sociological Research, 49(3), 25-26. 

Your instructor may prefer a paragraph indent, in which the first line of 
each entry is indented one-half inch: 

Sokolova, G. N. (2010). Economic stratification in Belarus and Russia: An 
experiment in comparative analysis. Sociological Research, 49(3), 25-26. 


• Spacing. Double-space the entire reference list. Do not add extra space 
between entries. 

• Page numbers. When citing a range of page numbers for an article, always 
give the complete numbers (for example, 121-124, not 121-24 or 121-4). If 
an article continues on subsequent pages after being interrupted by other 
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articles or advertisements, use a comma to separate the page numbers. 

Use the abbreviation p. or pp. only with articles in newspapers, chapters in 
edited books, and articles from proceedings published as a book. 

• Dates. Follow the format year, month, day, with a comma after only the 
year: (2011, October 31). 

Following are models of reference list entries for a variety of sources. For 
further examples of APA-style citations, consult the Publication Manual of the 
American Psychological Association. 

BOOKS 

1 0. Book by One Author Begin with the author’s last name, followed by the 
first initial or initials. Include a space between initials. Place the year of publi- 
cation in parentheses, then give the title of the book, followed by the location 
and name of the publisher. 

Power, G. A. (201 0). Dementia beyond drugs: Changing the culture of care. Baltimore, 

MD: Health Professions Press. 

1 1 . Book by Multiple Authors When citing a work by from two to seven 
authors, separate the authors’ names with a comma or commas, and use an 
ampersand (&) instead of and before the final author’s name. 

Tyshenko, M. G., & Paterson, C. (2010). SARS unmasked: Risk communication of 
pandemics and influenza in Canada. Montreal, Quebec, Canada: McGill-Queen's 
University Press. 

To cite more than seven authors, list only the first six, followed by three dots 
(an ellipsis) and the last author’s name. 

1 2. Multiple Books by the Same Author Arrange the entries by date, with the 
earliest date first. 

Tabloski, P. A. (2007). Clinical handbook for gerontological nursing. Upper Saddle 
River, NJ: Pearson/Prentice Hall. 

Tabloski, P. A. (2010). Gerontological nursing. Upper Saddle River, NJ: Pearson. 

If you use multiple works by the same author written in the same year, 
arrange the books alphabetically by title and include a, b, and so forth after 
the year — both in your reference list and in your parenthetical citations. 

Agger, B. (2007a). Fast families, virtual children: A critical sociology of families and 
schooling. Boulder, CO: Paradigm. 

Agger, B. (2007b). Public sociology: From social facts to literary acts. Lanham, MD: 
Rowman & Littlefield. 

1 3. Book Authored by an Organization Use the full name of the organization 
in place of an author’s name. If the organization is also the publisher, use the 
word Author in place of the publisher’s name. 

American Nurses Association. (201 0). Nursing's social policy statement: The essence 
of the profession (3rd ed.). Silver Spring, MD: Author. 
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APA: CITING A BOOK BY ONE AUTHOR 


When citing a book, use the information from the title page and the copyright page (on the 
reverse side of the title page), not from the book's cover or a library catalog. 



From George Packer, The Unwinding: An Inner 
History of the New America. 


0 THE 
UNWINDING 

AN INNER HISTORY OF 
THE NEW AMERICA 


GEORGE 

PACKER 


Farrar, Straus and Giroux 


1 •FARRAR. STRAUS AMO GIROUX 


New York 



Record the following information: 

A The author. Give the last name first, followed by a 
comma and initials for first and middle names. Separate 
initials with a space (Tufte, E. R.). Separate the names 
of multiple authors with a comma or commas; use an 
ampersand (&) before the final author's name. 

B The date of publication. Put the most recent copyright 
year in parentheses and end with a period (outside the 
parentheses). 

C The title. Give the full title; include the subtitle (if any), 
preceded by a colon. Italicize the title and subtitle, 
capitalizing only the first word of the title, the first 


word of the subtitle, and any proper nouns. End with a 
period. 

D The city of publication. If more than one city is given, 
use the first one listed. Include the name of both the 
city and the state (abbreviated) for publishers located in 
U.S. cities or the city and the country (not abbreviated) 
for publishers located in non-U.S. cities; for publishers in 
Canadian cities, also include the province. Insert a colon 
following the location. 

E The publisher. Give the publisher's name, omitting 
words such as Inc. and Co. Include and do not abbreviate 
terms such as University and Press. End with a period. 


I — ® — 1| — O - 1 © 1| — © — 1| © 1 

Packer, G. (2013). The unwinding: An inner history of the new America. New York, NY: Farrar, Straus and Giroux. 


For more APA-style models for citing other types of books, see pp. 62 1 and 623. 








Part B: Documenting Your Sources 


APA 


623 


14. Book by an Unknown Author If the author of the book is unknown, begin 
with the title in italics. 

The PDR pocket guide to prescription drugs (9th ed.). (2010). New York, NY: Pocket 
Books. 

1 5. Edited Book Place the abbreviation Ed. (singular) or Eds. (plural) in paren- 
theses after the name(s), followed by a period. 

Haugen, D., Musser, S., & Lovelace, K. (Eds.). (2010). Global warming. Detroit, Ml: 
Greenhaven Press. 

1 6. Chapter or Section in an Edited Book 

Jyonouchi, H. (2010). Possible impact of innate immunity in autism. In A. Chauhan, 

V. Chauhan, & W. T. Brown (Eds.), Autism: Oxidative stress, inflammation, and 
immune abnormalities (pp. 245-276). Boca Raton, FL: CRC Press. 

17. Book in an Edition Other Than the First Include the edition number in 
parentheses following the title. 

Quinn, G. R. (2010). Behavioral science (2nd ed.). New York, NY: McGraw-Hill Medical. 

1 8. Multivolume Work Include the number of volumes after the title. 

Weiner, I. B., & Craighead, W. E. (Eds.). (2010). The Corsini encyclopedia of psychology 
(Vols. 1-4). Hoboken, NJ: Wiley. 

1 9. Translated Book Name the translator after the title. 

Bieler, A., & Gutmann, H.-M. (2010). Embodying grace: Proclaiming justification in the 
real world (L. M. Maloney, Trans.). Minneapolis, MN: Fortress Press. 

20. Non-English Book Give the original title, then the English translation in 
brackets. 

Hernandez, G. H., Moreno, A. M., Zaragoza, F. G., & Porras, A. C. (Eds.). (2010). Tratado 
de medicina farmaceutica [Treaty of pharmaceutical medicine]. Madrid, Spain: 
Editorial Medica Panamericana. 

21 . Entry in a Reference Work Begin with the title of the entry if it has no author. 

Kohlrabi. (2010). In R.T. Wood (Ed.), The new whole foods encyclopedia: A 

comprehensive resource for healthy eating (2nd ed., pp. 1 78-1 79). New York, NY: 
Penguin Books. 

PERIODICALS 

22. Journal Article Follow the author’s name and the year of publication 
with the article title; then give the journal title, followed by a comma. For all 
journals, include the volume number (italicized). For journals that begin each 
issue with page 1, also include the issue number in parentheses (not itali- 
cized). Insert a comma and end with the page number(s). 

Cumsille, P., Darling, N., & Martinez, M. L. (2010). Shading the truth:The pattern 
of adolescents' decisions to avoid issues, disclose, or lie to parents. Journal of 
Adolescence, 33, 285-296. 
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APA: CITING AN ARTICLE FROM A PERIODICAL 


Periodicals include journals, magazines, and newspapers. This page gives an example of a 
citation for a print journal article. 



Source: Journal of Fish and Wildlife Manage- 
ment, 2010 . 



Record the following information: 

A The author. Give the last name first, followed by a 
comma and initials for first and middle names. Separate 
initials with a space (Tufte, E. R.). Separate the names 
of multiple authors with a comma or commas; use an 
ampersand (&) before the final author's name. 

B The date of publication. Put the year in parentheses 
and end with a period (outside the parentheses). For 
magazines and newspapers, include the month and, if 
given, the day (2011, May 23). 

C The article title. Give the full title; include the subtitle (if 
any), preceded by a colon. Do not underline or italicize 
the title or put it in quotation marks. Capitalize only the 


first word of the title, the first word of the subtitle, and 
any proper nouns. End with a period. 

D The periodical title. Italicize the periodical title and 
capitalize all major words. Follow the periodical title 
with a comma. 

E The volume number and issue number. Include the 
volume number (italicized). Include the issue number 
in parentheses (not italicized) for magazines and for 
journals that begin each issue at page 1 . Insert a comma. 

F Inclusive page numbers. Give all the numbers in full 
(316-337, not 316-37). For newspapers, include the ab- 
breviation p. for page (or pp. for pages) and the section 
letter, if relevant (p. D4). End with a period. 


I © ir O- ll © 

Britzke, E. R., Slack, B. A., Armstrong, M. P., & Loeb, S. C. (201 0). Effects of orientation and 


weatherproofing on the detection of bat echolocation calls. Journal of Fish and Wildlife 
Management, 1, 136-141. 



For more APA-style models for citing other types of periodical articles, see pp. 623 and 625. 

I To watch a tutorial on citing articles from periodicals in databases in APA style, go to "Tutorials" under "Additional Resources" in Appendix, 
Part B: macmillanhighered.com/launchpad/techcomm1 1 e. 
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23. Magazine Article Include the month after the year. If it’s a weekly maga- 
zine, include the day. Give the volume and issue numbers, if any, after the 
magazine title. 

Stix, G. (201 1, March). The neuroscience of true grit. Scientific American, 304(3), 28-33. 

24. Newspaper Article Include the specific publication date following the year. 

Seitz, J. (2010, December 26). Internet policies examined: Schools aim to clarify 
social rules. Boston Globe, p. 1 . 

25. Newsletter Article Cite a newsletter article as you would a magazine 
article. If the date is given as a season, insert a comma following the year 
and then include the season. 

Meyerhoff, M. K. (2010, September/October). Paying attention to attention. 

Pediatrics for Parents, 26(9/1 0), 8-9. 

ELECTRONIC SOURCES 

Generally, include all the same elements for electronic sources as you would 
for print sources. Include any information required to locate the item. Many 
scholarly publishers are now assigning a digital object identifier (DOI) to 
journal articles and other documents. A DOI is a unique alphanumeric string 
assigned by a registration agency. It provides a persistent link to unchanging 
content on the Internet. When available, substitute the DOI for a URL. If the 
content is subject to change, include the retrieval date before the URL. Use 
the exact URL for open-source material; use the home-page or menu-page 
URL for subscription-only material or content presented in frames, which 
make exact URLs unworkable. Break URLs before a punctuation mark, and 
avoid using punctuation after a URL or DOI so as not to confuse the reader. 

26. Nonperiodical Web Document To cite a nonperiodical web document, 
provide as much of the following information as possible: author’s name, 
date of publication or most recent update (use n.d. if there is no date), docu- 
ment title (in italics), and URL (or DOI, if available) for the document. 

Centers for Disease Control and Prevention. (201 0, June 1 ). Teens behind the 
wheel: Graduated driver licensing. Retrieved from http://www.cdc.gov 
/MotorVehicleSafety/Teen_Drivers/GDL/Teens_Behind_Wheel.html 

If the author of a document is not identified, begin the reference with the 
title of the document. If the document is from a university program’s web- 
site, identify the host institution and the program or department, followed by 
a colon and the URL for the document. 

Safety manual. (201 1, March 18). Retrieved from Harvard University, Center for 
Nanoscale Systems Web site: http://www.cns.fas.harvard.edu/users/Forms 
/CNS_Safety_Manual.pdf 

Journal Articles 

27. Article with DOI Assigned 

lemolo, F., Cavallaro,T„ & Rizzuto, N. (2010). Atypical Alzheimer's disease: A case 
report. Neurological Sciences, 3 1 , 643-646. doi:1 0.1 007/si 0072-01 0-0334-1 
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APA: CITING A NON PERIODICAL WEB DOCUMENT WITH NO DOI 


You will likely need to search the website where a document appears in order to find some 
of the citation information you need. For some sites, all of the details may not be available; 
find as many as you can. Remember that the citation you provide should allow readers to 
retrace your steps electronically to locate the source. 



0 


0 

© 


http://www.sunflowernsa.com 

/uploads/research/439/Klosterman 

_BirdDamage_10.pdf 


Assessment of Bird Damage to 
Sunflower and Corn in North Dakota 


Megan Klosterman 1 , George Linz 2 , 
Tony Slowik 3 , William Bleier 4 


Source: National Sunflower Association, 2010. 


Record the following information: 

A The author. Give the last name first, followed by a 
comma and initials for first and middle names. Separate 
initials with a space (Tufte, E. R.). Separate the names 
of multiple authors with a comma or commas; use an 
ampersand (&) before the final author's name. 

B The date of publication or most recent update. Put 

the date in parentheses and end with a period (outside 
the parentheses). If there is no date, use n.d. 


C The document title. Give the full title; include the 
subtitle (if any), preceded by a colon. Italicize the title 
and subtitle, capitalizing only the first word of the title, 
the first word of the subtitle, and any proper nouns. End 
with a period. 

D The URL. include the words Retrieved from before the 
complete URL. Insert a retrieval date before the word 
from only for material that is likely to change (e.g., wikis). 
Omit final punctuation. 


I © ipO-i | © 

Klosterman, M., Linz, G., Slowik, T., & Bleier, W. (2010). Assessment of bird damage to sunflower 

H -0- 

and corn in North Dakota. Retrieved from http://www.sunf1owernsa.com/uploads/research 
/439/Klosterman_BirdDamage_10.pdf 


For more APA-style models for citing other types of web sources, see pp. 625 and 627. 

■■■ To watch a tutorial on citing websites in APA style, go to "Tutorials" under"Additional Resources" in Appendix, Part B: 

1 macmillanhighered.com/launchpad/techcomm1 1 e. 
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28. Article with No DOI Assigned 

Srivastava, R. K., & More, A.T. (2010). Some aesthetic considerations for over-the- 
counter (OTC) pharmaceutical products. International Journal of Biotechnology, 

I /(3-4), 267-283. Retrieved from http://www.inderscience.com 

29. Preprint Version of Article 

Wang,T. J. ( Larson, M. G.,Vasan, R. S., Cheng, S., Rhee, E. R, McCabe, E., . . . Gerszten, 

R. E. (201 1 ). Metabolite profiles and the risk of developing diabetes. Nature 
Medicine. Advance online publication. doi:1 0.1 038/nm.2307 

Electronic Books 

30. Entire Book Use “Retrieved from” if the URL leads to the information itself and 

“Available from” if the URL leads to information on how to obtain the content. 

Einstein, A. (n.d.). Relativity: The special and general theory. Retrieved from http:// 
www.gutenberg.org/etext/5001 

Dissertations and Theses 

31 . Dissertation Retrieved from Database For a commercial database, include 

the database name, followed by the accession number. For an institutional 

database, include the URL. 

Siegel, R. S. (2010). Mediators of the association between risk for mania and close 
relationship quality in adolescents (Doctoral dissertation). Retrieved from http:// 
scholarlyrepository.miami.edu/oa_dissertations/426 

Reference Materials 

Give the home-page or index-page URL for reference works. 

32. Online Encyclopedia 

Cross, M. S. (201 1 ). Social history. In J. H. Marsh (Ed.), The Canadian encyclopedia. 
Retrieved from http://www.thecanadianencyclopedia.com 

33. Online Dictionary 

Conductance, (n.d.). In Merriam-Webster's online dictionary. Retrieved from http:// 
www.merriam-webster.com/dictionary/conductance 

34. Wiki 

Tsunami, (n.d.). Retrieved March 20, 201 1,from http://en.wikipedia.org/wiki/Tsunami 

Raw Data 

35. Data Set 

Department of Health and Human Services. (201 0). FDA peanut product recalls [Data 
set]. Retrieved from http://www.data.gov/communities/node/81/data_tools/350 

36. Graphic Representation of Data 

U.S. Department of Labor, Bureau of Labor Statistics. (201 1, April 4). Civilian 
unemployment rate (UNRATE) [Line graph]. Retrieved from Federal Reserve 
Bank of St. Louis Web site: http://research.stlouisfed.org/fred2/series/UNRATE 
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APA: CITING AN ARTICLE WITH A DO 




Journal of Business and Technical Communication 
Volume 22 Number 3 
July 2008 364-391 Q 
2008 Sage Publications ( i 
10.1172/1050651908315985 Q 


Amy Koerber 
E. Jonathan Arnett 
Tamra Cumbie 


From Journal of Business and Technical 
Communication, Vol. 22, No. 3, July 
2008. Used by permission of Sage 
Publications, Inc. 


Record the following information: 

A The author. Give the last name first, followed by a 
commaand initials forfirst and middle names. Separate 
initials with a space (Tufte, E. R.). Separate the names of 
multiple authors with a comma or commas; use an am- 
persand (&) before the final author's name. 

B The date of publication. Put the year in parentheses 
and end with a period (outside the parentheses). For 
magazines and newspapers, include the month and, if 
relevant, the day (2006, May 23). 

C The article title. Give the full title; include the subtitle (if 
any), preceded by a colon. Do not underline or italicize 
the title or put it in quotation marks. Capitalize only the 
first word of the title, the first word of the subtitle, and 
any proper nouns. End with a period. 


D The periodical title. Italicize the periodical title and 
capitalize all major words. Follow the periodical title 
with a comma. 

E The volume number and issue number. For journals 
and magazines, include the volume number (italicized). 
Include the issue number in parentheses (not italicized) 
for magazines and for journals that begin each issue at 
page 1 . Insert a comma. 

F Inclusive page numbers. Give all the numbers in full 
(316-337, not 31 6-37). For newspapers, include the ab- 
breviation p. for page (or pp. for pages) and the section 
letter, if relevant (p. D4). End with a period. 

G The DOI. If the DOI is assigned to a preprint version of the 
article, include the expression Advance online publication, 
which is followed by a period. End with doi followed by a 
colon, no space, then the DOI. Omit final punctuation. 


© 



0 


Koerber, A., Arnett, E. J., & Cumbie, T. (2008). Distortion and the politics of pain relief: A Habermasian 


© 



analysis of medicine in the media. Journal of Business and Technical Communication, 22, 

r®hi ® i 


364-391 . doi:1 0.1 1 72/1 050651908315985 


For more APA-style models for citing other types of electronic sources, see pp. 627, 629, and 630. 

■■■ To watch a tutorial on citing articles from databases in APA style, go to "Tutorials" under"Additional Resources" in Appendix, Part B: 

1 macmillanhighered.com/launchpad/techcomm1 1 e. 
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37. Qualitative Data 

Jaques, C. (2010). They called it slums but it was never a slum to me [Audio stream]. 
Retrieved from StoryCorps Web site: http://storycorps.org/listen/stories 
/category/historias 

Other Electronic Documents 

38. Technical or Research Report 

Moran, R., Rampey, B. D., Dion, G. S., & Donahue, P. L. (2008). National Indian education 
study 2007, Part I. Performance of American Indian and Alaska native students at 
grades 4 and 8 on NAEP2007 reading and mathematics assessments (Report No. 

NCES 2008-457). Retrieved from National Center for Education Statistics Web site: 
http://nces.ed.gov/nationsreportcard/pdf/studies/2008457.pdf 

39. Presentation Slides 

Wyominginspector. (2010). Cell phone use in the mining industry [PowerPoint slides]. 
Retrieved from http://www.slideshare.net/wyominginspector/cell-phone-use-in 
-the-mining-industry 

General-Interest Media and Alternative Presses 

40. Newspaper Article 

Applebaum, A. (201 1, February 14). Channeling Egypt's energy of the crowd 
into positive change. The Washington Post. Retrieved from http://www 
.washingtonpost.com 

41 . Audio Podcast Include the presenter, producer, or other authority, if 
known; date; episode title; any episode or show identifier in brackets, such 
as [Show 13 ]; show name; the words Audio podcast in brackets; and retrieval 
information. 

Cooper, Q. (Presenter). (201 1, February 10). Science in Egypt. The Material World 
[Audio podcast]. Retrieved from http://www.bbc.co.uk/podcasts/series 
/material#playepisode8 

42. Online Magazine Content Not Found in Print Version 

Greenemeier, L. (201 0, November 1 7). Buzz kill: FDA cracks down on caffeinated 
alcoholic beverages. Scientific American. Retrieved from http://www 
.scientificamerican.com/article.cfm?id5fda-caffeinated-alcohol 

Online Communities 

43. Message Posted to an Electronic Mailing List, Online Forum, or Dis- 
cussion Group If an online posting is not archived and therefore is not 
retrievable, cite it as a personal communication and do not include it in 
the reference list. If the posting can be retrieved from an archive, provide 
the author’s name (or the author’s screen name if the real name is not 
available), the exact date of the posting, the title or subject line or thread 
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name, and a description of the type of post in brackets. Finish with the 
address. 

Gomez, T. N. (2010, December 20). Food found in archaeological environments 
[Electronic mailing list message]. Retrieved from http://cool.conservation-us 
.org/byform/mailing-lists/cdl/201 0/1 297.html 

44. Blog Post 

Joseph j7uy5. (201 0, May 1 1 ). Another rTMS update [Web log post]. Retrieved 
from http://scienceblogs.com/corpuscallosum/2010/05/another_rtms 
_update.php 

Telecom. (201 1 , February 22). Cellphone use tied to changes in brain activity [Web 
log comment]. Retrieved from http://well.blogs.nytimes.com/201 1/02/22 
/cellphone-use-tied-to-changes-in-brain-activity/#comment-643942 

45. Email Message or Real-Time Communication Do not cite email messages 
in the reference list. Instead, cite them in the text as personal communica- 
tions. (See item 8 on page 619.) 


OTHER SOURCES 

46. Technical or Research Report Include an identifying number in parenthe- 
ses after the report title. If appropriate, include the name of the service used 
to locate the item in parentheses after the publisher. 

Arai, M., & Mazuka, R. (2010). Linking syntactic priming to language development: 

A visual world eye-tracking study (TL201 0-1 8). Tokyo: Institute of Electronics, 
Information and Communication Engineers. 

47. Government Document For most government agencies, use the abbrevia- 
tion U.S. instead of spelling out United States. Include any identifying docu- 
ment number after the publication title. 

U.S. Department of State. (2010, June). Trafficking in persons report (1 Oth ed.). 
Washington, DC: Government Printing Office. 

48. Brochure or Pamphlet After the title of the document, include the word 
Brochure or Pamphlet in brackets. 

U.S. Department of Health and Human Services, Centers for Disease Control and 
Prevention. (2010, October). Howto clean and disinfect schools to help slow the 
spread of flu [Pamphlet], Washington, DC: Author. 

49. Article from Conference Proceedings After the proceedings title, give the 
page numbers on which the article appears. 

Sebastianelli, R.,Tamimi, N., Gnanendran, K., & Stark, R. (2010). An examination of 
factors affecting perceived quality and satisfaction in online MBA courses. In 
Proceedings of the 4 1 st Annual Meeting of the Decision Sciences Institute 
(pp. 1641-1646). Atlanta, GA: Decision Sciences Institute. 
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50. Lecture or Speech 

Culicover, P. W. (2010, March 3). Grammar and complexity: Language at the 

intersection of competence and performance. Lecture presented at the Ohio State 
University, Columbus, OH. 

51. Audio Recording Give the role (narrator, producer, director, or the like) of 
the person whose name appears at the beginning of the entry in parentheses 
after the name. Give the medium in brackets after the title. 

Young, J. K. (Lecturer). (2007). The building blocks of human life: Understanding 
mature cells and stem cells [CD], Prince Frederick, MD: Recorded Books. 

52. Motion Picture Give the name of at least one primary contributor, such 
as the producer or director, and follow the film’s title with the words Motion 
picture in brackets. List the country in which the film was produced and the 
studio’s name. If the film was not widely distributed, give instead the distrib- 
utor’s name and address in parentheses. 

Fincher, D. (Director). (2010). The social network [Motion picture]. United States: 
Columbia Pictures. 

53. Television Program Start with the director, producer, or other principal 
contributor and the date the program aired. Include the words Television 
broadcast or Television series in brackets after the program title. 

Fine, S. (Executive Producer). (201 1). NOVA scienceNOW [Television series]. Boston, 

MA: WGBH. 

For a single episode in a television series, start with the writer and director of 
the episode or other relevant editorial personnel. Include the words Televi- 
sion series episode in brackets after the episode title. Also include information 
about the series. End with the location and name of the station or network. 

Dart, K., Evans, N., & Stubberfield,T. (Producers & Directors). (2010, October 26). 
Emergency mine rescue [Television series episode]. In H. Swartz (Executive 
Producer), NOVA. Boston, MA: WGBH. 

54. Published Interview If it is not clear from the title that the entry is an 
interview, or if there is no title, include the words Interview with and the sub- 
ject’s name in brackets. 

Jackson, L. (2010, December 6). The EPA is not the villain [Interview with Daniel 
Stone]. Newsweek, 156(23), 14. 

55. Personal Interview Consider interviews you conduct, whether in person 
or over the telephone, as personal communications and do not include them 
in the reference list. Instead, cite them in the text. (See item 8 on page 619.) 

56. Personal Correspondence Like emails, personal letters and memos 
should not be included in the reference list. Instead, cite them in the text. 

(See item 8 on page 619.) 
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57. Unpublished Data Where the title would normally appear, include a 
description of the data in brackets. 

Standifer, M. (2007). [Daily temperatures, 2007, Barton Springs municipal pool, 
Austin, TX], Unpublished raw data. 

SAMPLE APA REFERENCE LIST 

Following is a sample reference list using the APA citation system. 


Nonperiodical web document with 
no DOI 


Journal article, paginated by 
volume 


Online article with a DOI 


Chapter in an edited book 


Book in an edition other than the 
first 

Online article, paginated by 
issue, with no DOI 


REFERENCES 

Centers for Disease Control and Prevention. (2010, June 1 ). Teens behind the 
wheel: Graduated driver licensing. Retrieved from http://www.cdc 
.gov/MotorVehicleSafety/Teen_Drivers/GDL/Teens_Behind_Wheel 
.html 

Cumsille, P., Darling, N., & Martinez, M. L. (2010). Shading the truth:The pattern 
of adolescents' decisions to avoid issues, disclose, or lie to parents. Journal 
of Adolescence, 33, 285-296. 

lemolo, F., Cavallaro, T., & Rizzuto, N. (201 0). Atypical Alzheimer's disease: A 
case report. Neurological Sciences, 31 , 643-646. doi:1 0.1 007/s 1 0072-010 
-0334-1 

Jyonouchi, H. (201 0). Possible impact of innate immunity in autism. In 
A. Chauhan, V. Chauhan, & W. T. Brown (Eds.), Autism: Oxidative stress, 
inflammation, and immune abnormalities (pp. 245-276). Boca Raton, FL: CRC 
Press. 

Quinn, G. R. (2010). Behavioral science (2nd ed.). New York, NY: McGraw-Hill 
Medical. 

Srivastava, R. K., & More, A.T. (2010). Some aesthetic considerations for over-the- 
counter (OTC) pharmaceutical products, international Journal of Biotechnology, 
11(3-4), 267-283. Retrieved from http://www.inderscience.com 
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IEEE Style 

IEEE style consists of two elements: citations in the text and a reference list 
at the end of the document. 


IEEE Style for Reference List Entries 


BOOKS 

1 . Book by One Author 635 

2. Book by Multiple Authors 635 

3. Book Authored by an 
Organization 635 

4. Edited Book 635 

5. Chapter or Section in an Edited 
Book 635 

6. Book in an Edition Other Than the 
First 635 

PRINT PERIODICALS 

7. Journal Article 637 

8. Magazine Article 637 

9. Newspaper Article 637 


ELECTRONIC SOURCES 

10. Article in an Online Journal or 
Magazine 637 

11. Website 637 

12. Document on a Government 
Website 637 

OTHER SOURCES 

13. Thesis or Dissertation 637 

14. Standard 637 

15. Scientific or Technical Report 637 

16. Paper Published in Conference 
Proceedings 640 

17. Government Document 640 

18. Unpublished Document 640 


IEEE TEXTUAL CITATIONS 

In the IEEE (originally, Institute of Electrical and Electronics Engineers) docu- 
mentation system, citations in the text are bracketed numbers, keyed to a 
numbered list of references that appears at the end of the document. Entries 
in the list are arranged in the order in which they are cited in the text and are 
numbered sequentially. Once a reference has been listed, the same number is 
used in all subsequent citations of that source. 

To cite references in the text, place the reference number or numbers 
immediately after the author’s name, in square brackets, before any punctua- 
tion. Use et al. if there are three or more author names. 

A recent study by Goldfinkel [5] shows that this is not an efficient solution. Murphy 
[8]— [1 0] comes to a different conclusion. 

You can also use the bracketed citation number or numbers as a noun. 

In addition, [5] shows that this is not an efficient solution; however, [8]— [1 0] come to a 
different conclusion. 

NOTE: Because references are listed in the order in which they first appear in the 
text, if you add a new citation within the text while rewriting or editing, you 
will need to renumber the reference list as well as the citations in the text. 

For example, if in rewriting you were to add a new reference between the first 
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citations of the Murphy references originally numbered [8] and [9], the previ- 
ous example would then read: 

[8], [1 0], [1 1 ] come to a different conclusion. 

To make a reference more precise, you can provide extra information. 

A recent study by Goldfinkel [5, pp. 1 2-1 9] shows that this is not an efficient solution. 

THE IEEE REFERENCE LIST 

The following guidelines will help you prepare lEEE-style references. For 

additional information on formatting entries, consult the latest edition of The 

Chicago Manual of Style. 

• Arranging entries. Arrange the entries in the order in which they first are 
cited in the text, and then number them sequentially. Place the numbers 
in square brackets and set them flush left in a column of their own, 
separate from the body of the references. Place the entries in their own 
column, with no indents for turnovers. 

• Authors. List the author’s first initial (or first and middle initials, 
separated by spaces), followed by the last name. In the case of multiple 
authors, use all names; use et al. after the first author’s name only if 
the other names are not given. If an entry has an editor or translator in 
place of an author, add the abbreviation Ed. (or Eds. for editors) or Trans, 
following the name. 

• Book titles. Italicize titles of books. In English, capitalize the first word and all 
major words. In foreign languages, capitalize the first word of the title and 
subtitle, as well as any words that would be capitalized in that language. 

• Publication information. For books, give the city of publication, the country 
(if other than the United States), the publisher’s name (abbreviated), and 
the year of publication. When two or more cities are given on a book’s 
copyright page, include only the first. If the city is not well known, add 
the abbreviation for the name of the state or province (in Canada). If the 
publisher’s name indicates the state, no state abbreviation is necessary. 

• Periodical titles. Italicize and abbreviate titles of periodicals. Capitalize all 
major words in the title. 

• Article titles. Place titles of print articles in quotation marks; do not use 
quotation marks for titles of articles found in electronic sources. Capitalize 
the first word of the title and subtitle. Do not capitalize the remaining 
words unless they are proper nouns. 

• Electronic sources. Follow the special style for electronic sources in 
which, most notably, the sequence of information is different from 
that for print material (the date follows the author, and the year comes 
before the month). Do not place article titles in quotation marks, and use 
periods rather than commas to separate sections. In addition to the basic 
information, give the medium and provide a way to locate the source by 
including, for example, a URL. 
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• Spacing. Single-space the reference list, and do not add extra space 
between entries. 

• Page numbers. To give a page or a range of pages for a specific article in 
a book or periodical, use the abbreviation p. or pp. Write numbers in full 
(152-159, not 152-59 or 152-9). 

• Dates. For print sources, follow the format month (abbreviated), day, year 
(for example, Apr. 3, 2010 or Feb. 22-23, 2011). Do not abbreviate May, June, 
or July. For electronic sources, follow the format year, month (abbreviated), 
day (for example, 2011, Oct. 14). 

BOOKS 

1 . Book by One Author Include the author’s first initial and middle initial 
(if available), the author’s last name, the book title (in italics), the place of 
publication, the publisher, the year of publication, and the page range of the 
material referenced. 

[1 ] B. Mehlenbacher, Instruction and Technology: Designs for Everyday Learning. 
Cambridge, MA: MIT Press, 2010, pp. 22-28. 

2. Book by Multiple Authors List all the authors’ names. Use et al. after the first 
author’s name only if the other names are not given. Do not invert names, and 
include a comma before and only if there are three or more names. 

[2] S.-T. Yau and S. J. Nadis, The Shape of Inner Space: String Theory and the Geometry of 
the Universe's Hidden Dimensions. New York: Basic Books, 2010, pp. 254-255. 

3. Book Authored by an Organization The organization takes the place of the 
author. 

[3] World Bank, World Development Report 201 1: Conflict, Security, and Development. 
Washington, DC: World Bank, 201 1, pp. 25-31. 

4. Edited Book Include the abbreviation Ed. (singular) or Eds. (plural) after the 
name(s). 

[4] J. Dibbell, Ed., The Best Technology Writing 2010. New Haven: Yale University Press, 
2010, pp. 157-162. 

5. Chapter or Section in an Edited Book Give the author and the title of the 
chapter or section first (enclosed in quotation marks and with only the 
first word capitalized), followed by the word in, the book title, and the book 
editor(s). Then give the publication information for the book and the page 
numbers where the chapter or section appears. 

[5] E. Castronova,"The changing meaning of play," in Online Communication and 
Collaboration: A Reader, H. M. Donelan, K. L. Kear, and M. Ramage, Eds. New York: 
Routledge, 2010, pp. 1 84-1 89. 

6. Book in an Edition Other Than the First The edition number follows the title 
of the book and is preceded by a comma. 


[6] L. Xinju , Laser Technology, 2nd ed. Boca Raton, FL: CRC Press, 2010, pp. 203-205. 
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IEEE: CITING A BOOK BY ONE AUTHOR 


When citing a book, use the information from the title page and the copyright page (on the 

reverse side of the title page), not from the book's cover or a library catalog. I 

State University of New York Press, Albany 



Record the following information: 

A The author. Give the initials for the first and middle 
names, followed by the last name. Separate initials with 
a space. End with a comma. 

B The title. Give the full title in italics; include the subtitle 
(if any), preceded by a colon. Capitalize the first word 
of the title, the first word of the subtitle, and all major 
words. End with a period. 

C The place of publication. If more than one city is given, 
use the first one listed. For a city that may be unfamiliar 
to your readers or confused with another city, add an ab- 


breviation of the state or province (in Canada): Sweetwa 
ter, TX. Give the country if not the United States: Milan, 
Italy. Insert a colon. 

D The publisher. Use a concise version of the publisher's 
name. End with a comma. 

E The date of publication. Use the publication date, if 
given. Otherwise, use the copyright date. End with a 
comma. 

F The pages referenced. Give the page range of the 
material referenced, preceded by p. or pp. 


I — ® — 1 | ® 

[3] E. P. Shea, How the Gene Got Its Groove: Figurative Language, Science, and the Rhetoric of 

iHhi 

the Real. Albany: State Univ. of New York Press, 2008, pp. 59-78. 


For more lEEE-style models for citing other types of books, see p. 635. 
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PRINT PERIODICALS 

7. Journal Article Include the author, the article title, and the journal title 
(abbreviated where possible), followed by the volume number, issue number, 
page number(s), abbreviated month, and year (or abbreviated month, day, and 
year for weekly periodicals). 

[7] R. C. Weber, P.-Y. Lin, E. J. Garnero, Q. Williams, and P. Lognonne, "Seismic detection 
of the lunar cor e" Science, vol. 331, no. 6015, pp. 309-312, Jan. 21, 201 1. 

8. Magazine Article List the author, the article title, and the magazine title 
(abbreviated where possible), followed by the page number(s) and the issue date. 

[8] J. Villasenor, "The hacker in your hardware,' 'Scientific Amer., pp. 82-87, Aug. 2010. 

9. Newspaper Article List the author, the article title, and the newspaper 
name, followed by the section and the date. 

[9] M. Woolhouse,"For many, snow day is business as usual," Boston Globe, sec. B, Jan. 
13, 2011. 

ELECTRONIC SOURCES 

1 0. Article in an Online Journal or Magazine 

[1 0] R. Marani and A. G. Perri. (2010). An electronic medical device for preventing and 
improving the assisted ventilation of intensive care unit patients. Open Elect. 
Electron. Eng. J. [Online]. 4, pp. 1 6-20. Available: http://www.benthamscience.com 
/open/toeej/openaccess2.htm 

1 1 . Website 

[1 1] American Institute of Physics. (201 1). American Institute of Physics [Online]. 
Available: http://www.aip.org 

1 2. Document on a Government Website 

[1 2] U.S. Department of Health and Human Services, Centers for Disease Control and 
Prevention. Preparation and planning for bioterrorism emergencies [Online], 
Available: http://emergency.cdc.gov/bioterrorism/prep.asp 

OTHER SOURCES 

1 3. Thesis or Dissertation 

[13] J. L. Beutler, "Frequency response and gain enhancement of solid-state impact- 
ionization multipliers (SIMs)," Ph.D. dissertation, Dept. Elect. Eng., Brigham Young 
Univ., Provo, UT, 2010. 

14. Standard For standards, include the title in italics, the standard number, 
and the date. 

[1 4] Testing and Evaluation Protocol for Spectroscopic Personal Radiation Detectors 
(SPRDs) for Homeland Security, ANSI Standard T&E Protocol N42.48, 2010. 

15. Scientific or Technical Report 

[1 5] E. G. Fernando, "Investigation of rainfall and regional factors for maintenance 
cost allocation," Texas Transportation Inst. Texas A&M, College Station, TX, Report 
5-4519-01-1, Aug. 2010. 
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IEEE: CITING AN ARTICLE FROM A PRINT PERIODICAL 


Periodicals include journals, magazines, and newspapers. This page gives an example of a 
citation for a print journal article. 


the Journal of 
Symplectic 
Geometry 


(i) = £ dp. A dq* 



From The Journal of Symplectic Geometry, Volume 5, Issue 4, December 2007. Reprinted by permission of 
International Press of Boston. 


Record the following information: 

A The author. Give the initials for the first and middle 
names, followed by the last name. Separate initials with 
a space. End with a comma. 

B The article title. Give the full title; include the subtitle (if 
any), preceded by a colon. Capitalize only the first word 
of the title, the first word of the subtitle, and proper 
nouns. End with a comma. Enclose all in quotation 
marks. 

C The periodical title. Give the abbreviated title, in italics, 
with each word capitalized. End with a comma. 


D The volume number and issue number. Include the 
volume and issue numbers, using the abbreviations vol. 
and no. Follow each number with a comma. 

E Inclusive page numbers. Give the page range for the 
article. End with a comma. 

F The date of publication. Give the abbreviated month, 
followed by the year or the day and year. End with a 
period. 


rO— 1| © 1| © 1 

[9] E. Katz, "An algebraic formulation of symplectic field theory," J. Symplectic Geometry, 

|— — O — 1 | Q 1^0^ 

vol. 5, no. 4, pp. 385-437, Dec. 2007. 


For more lEEE-style models for citing other types of periodical articles, see p. 637. 
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IEEE: CITING AN ARTICLE FROM AN ONLINE DATABASE 



Record the following information: 

A The author. Give the initials for the first and middle 
names, followed by the last name. Separate initials with 
a space. End with a period. 

B The date of the article's online publication. In pa- 
rentheses, put the year, followed by a comma, then the 
abbreviated month, and the day (if available). End with a 
period. 

C The article title. Include the title, followed by a period 
(unless the title ends with its own punctuation). Capital- 
ize only the first word of the title, the first word of the 
subtitle, and proper nouns. Do not enclose the article 
title in quotation marks or italicize it. 


D The periodical title. Give the abbreviated journal title 
in italics. Do not end with a period if the last word is 
spelled out in full. 

E Medium. Place the medium in square brackets and end 
with a period: [Online]. 

F The volume number, issue number, and pages. Put 

the issue number in parentheses immediately after the 
volume number, and italicize the volume number and 
issue number. Give the page numbers where the article 
appears, if known, preceded by a comma. End with a 
period. 

G Retrieval information. After the word Available: and a 
space, include the URL for the database or the article. Do 
not end with punctuation unless the URL does. 


I © 1| — © | © 

[22] X. Zhao, N. Huebsch, D. J. Mooney, and Z. Suo. (201 0, Mar. 23). Stress-relaxation behavior 

® © © © 

in gels with ionic and covalent crosslinks. J.Appl. Phys. [Online]. 107(6). Available: 


http://www.ncbi.nlm.nih.gov/pmc/articles/PMC3069988/7tookpmcentrez 


For more lEEE-style models for citing other types of electronic sources, see p. 637. 
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16. Paper Published in Conference Proceedings 

[16] T. O'Brien, A. Ritz, B. J. Raphael, and D. H. Laidlaw, "Gremlin: An interactive 
visualization model for analyzing genomic rearrangements," in Proc. IEEE 
Information Visualization Conf., 2010, vol. 1 6, no. 6, pp. 918-926. 

1 7. Government Document 

[1 7] W. R. Selbig and R. T. Bannerman, "Characterizing the size distribution of particles 
in urban stormwater by use of fixed-point sample-collection methods," U.S. 
Geological Survey, Open-File Report 201 1-1052, 201 1. 

18. Unpublished Document 

[1 8] S. Reed, "An approach to evaluating the autistic spectrum in uncooperative 
adolescents," unpublished. 

SAMPLE IEEE REFERENCE LIST 

Following is a sample reference list using the IEEE numbered reference sys- 
tem. The references are listed in the order in which they might appear in a 
fictional document. 


Article in an online magazine 
Chapter in an edited book 

Book in an edition other than 
the first 

Online journal article 

Standard 
Journal article 


Reference List 

[1] S. Schmidt. (2008, June). Arthur C. Clarke, 1917-2008. Analogs f 
.com [Online], Available: http://www.analogsf.com/0806 
/Obitclarke . shtml 

[2] E. Castronova, “The changing meaning of play,” in Online Communi- 
cation and Collaboration: A Reader. H. M. Donelan, K. L. Kear, 
and M. Ramage, Eds. New York: Routledge, 2010, pp. 184—189. 

[3] L. Xinju, Laser Technology, 2nd ed. Boca Raton, FL: CRC Press, 
2010, pp. 203-205. 

[4] R. Marani and A. G. Perri. (2010). An electronic medical device for 
preventing and improving the assisted ventilation of intensive care 
unit patients. Open Elect. Electron. Eng. J. [Online], 4, pp. 16-20. 
Available: http://www.benthamscience.com/open/toeej/openaccess2 
.htm 

[5] Testing and Evaluation Protocol for Spectroscopic Personal Radiation 
Detectors ( SPRDs) for Homeland Security, ANSI Standard T&E 
Protocol N42.48, 2010. 

[6] A. C. Mathieson, E. J. Elehre, C. J. Dawes, and C. D. Neefus, “An 
historical comparison of seaweed populations from Casco Bay, 
Maine,” Rhodora, vol. 110, no. 941, pp. 1-10, 2008. 
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MLA Style 

MLA (Modern Language Association) style consists of two elements: citations 
in the text and a list of works cited at the end of the document. 


MLA Style for Textual Citations 


1. Entire Work 642 

2. Specific Page(s) 642 

3. Work Without Page Numbers 642 

4. Multiple Sources by the Same 
Author 642 

5. Source with Multiple Authors 643 

6. Source Quoted Within Another 
Source 643 

7. Source Authored by an 
Organization 643 


8. Source with an Unknown Author 643 

9. Multiple Sources in One Citation 644 

1 0. Multiple Authors with the Same Last 
Name 644 

1 1 . Chapter or Section in an Edited 
Book 644 

12. Multivolume Work 644 

13. Entry in a Reference Work 644 

14. Electronic Source 644 


MLA Style for Works-Cited Entries 


BOOKS 

1 5. Book by One Author 647 

1 6. Book by Multiple Authors 647 
1 7. Multiple Books by the Same 

Author 647 

18. Book Authored by an 
Organization 647 

1 9. Book by an Unknown Author 647 

20. Edited Book 647 

21 . Chapter or Section in an Edited 
Book 648 

22. Book in an Edition OtherThan the 
First 648 

23. Multivolume Work 648 

24. Book That Is Part of a Series 648 

25. Translated Book 648 

26. Book in a Language OtherThan 
English 648 

27. Entry in a Reference Work 648 

PRINT PERIODICALS 

28. Journal Article 650 

29. Magazine Article 650 

30. Newspaper Article 650 


31 . Unsigned Article 650 

32. ArticleThat Skips Pages 650 

33. Review 650 

ELECTRONIC SOURCES 

34. Entire Website 650 

35. Short Work from a Website 652 

36. Online Book 652 

37. Article in an Online Periodical 652 

38. Article from a Database or Subscription 
Service 652 

39. Dissertation 652 

40. CD-ROM 652 

41 . Email Message 654 

42. Online Posting 654 

43. Other Online Sources 654 

OTHER SOURCES 

44. Government Document 654 

45. Article from Conference 
Proceedings 655 

46. Pamphlet 655 

47. Report 655 

48. Interview 655 


( continued ) 
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49. Letter or Memo 655 

50. Lecture or Speech 655 

51 . Map or Chart 656 

52. Photograph or Work of Art 656 


53. Legal Source 656 

54. Radio orTelevision Program 656 

55. Film, Video, or DVD 656 

56. Advertisement 657 


MLA TEXTUAL CITATIONS 

In MLA style, the textual citation typically includes the name of the source’s 
author and the number of the page being referred to. Textual citations vary 
depending on the type of source cited and the context of the citation. The 
following models illustrate a variety of common situations; for additional 
examples, consult the MLA Handbook for Writers of Research Papers. 

1 . Entire Work If you are referring to the whole source, not to a particular 
page or pages, use only the author’s name. 

Harwood's work gives us a careful framework for understanding the aging process 
and how it affects communication. 

2. Specific Page(s) Immediately following the material you are quoting or 
paraphrasing, include a parenthetical reference with the author’s name 
and the page number(s) being referred to. Do not add a comma between the 
name and the page number, and do not use the abbreviation p. or pp. 

Each feature evolves independently, so there can't be a steady progression of fossils 
representing change (Prothero 27). 

If your sentence already includes the author’s name, put only the page 
number in the parenthetical citation. 

Prothero explains why we won't find a steady progression of human fossils 
approaching modern humans, as each feature evolves independently (27). 

3. Work Without Page Numbers Give a paragraph, section, or screen number, 
if provided. Use par. (singular) or pars, (plural) to indicate paragraph numbers. 
Either spell out or use standard abbreviations (such as col., fig., pt., ch., or I.) for 
other identifying words. Use a comma after the author’s name if it appears in 
the parenthetical citation. 

Under the right conditions, humanitarian aid forestalls health epidemics in the 
aftermath of natural disasters (Bourmah, pars. 3-6). 

Maternal leave of at least three months has a significantly positive effect on the 
development of attachment in the infant (Ling, screen 2). 


4. Multiple Sources by the Same Author If you cite two or more sources 
by the same author, either include the full source title in the text or add 
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a shortened title after the author’s name in the parenthetical citation to 
prevent confusion. 

Chatterjee believes that diversification in investments can take many forms 
( Diversification 1 3). 

Risk is a necessary component of a successful investment strategy (Chatterjee, 

Failsafe 25). 

5. Source with Multiple Authors For a source written by two or three authors, 
cite all the names. 

Grendel and Chang assert that . . . 

This phenomenon was verified in the late 1 970s (Grendel and Chang 281 ). 

For a source written by four or more authors, either list all the authors or 
give only the first author, followed by the abbreviation et al. Follow the same 
format as in the works-cited list. 

Studies show that incidences of type 2 diabetes are widespread and rising quickly 
(Gianarikas et al.). 

6. Source Quoted Within Another Source Give the source of the quotation in 
the text. In the parenthetical citation, give the author and page number(s) of 
the source in which you found the quotation, preceded by qtd. in. 

Freud describes the change in men's egos as science proved that the earth was 
not the center of the universe and that man was descended from animals (qtd. in 
Prothero 89-90). 

Only the source by Prothero will appear in the list of works cited. 

7. Source Authored by an Organization If the author is an organization rather 
than a person, use the name of the organization. When giving the organiza- 
tion’s name in parentheses, abbreviate common words. 

In a recent booklet, the Association of Sleep Disorders discusses the causes of 
narcolepsy (2-3). 

The causes of narcolepsy are discussed in a recent booklet (Assn, of Sleep 
Disorders 2-3). 

8. Source with an Unknown Author If the source does not identify an author, 
use a shortened form of the title in your parenthetical citation. 

Multidisciplinary study in academia is becoming increasingly common 
("Interdisciplinary" 23). 

In a web document, the author’s name is often at the end of the document or 
in small print on the home page. Do some research before assuming that a 
website does not have an author. Remember that an organization may be the 
author. (See item 7.) 
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For a sample MLA-style list of works 
cited, see p. 657. 


REFERENCE HANDBOOK 

9. Multiple Sources in One Citation When you refer to two or more sources at 
the same point, separate the sources with a semicolon. 

Much speculation exists about the origin of this theory (Brady 42; Yao 388). 

1 0. Multiple Authors with the Same Last Name If the authors of two or more 
sources have the same last name, spell out the first names of those authors 
in the text and use the authors’ first initials in the parenthetical citation. 

In contrast, Albert Martinez has a radically different explanation (29). 

The economy's strength may be derived from its growing bond market (J. Martinez 87). 

1 1 . Chapter or Section in an Edited Book Cite the author of the work, not the 
editor of the anthology. 

Wolburg and Treise note that college binge drinkers include students with both high 
and low GPAs (4). 

1 2. Multivolume Work If you use only one volume of a multivolume work, 
list the volume number in the works-cited list only. If you use more than one 
volume of a multivolume work, indicate the specific volume you are referring 
to, followed by a colon and the page number, in your parenthetical citation. 

Many religious organizations opposed the Revolutionary War (Hazlitt 2: 423). 

1 3. Entry in a Reference Work If the entry does not have an author, use the 
word or term you looked up. You do not need to cite page numbers for entries 
in encyclopedias and dictionaries because they are arranged alphabetically. 

The term groupism is important to understand when preparing to communicate with 
Japanese business counterparts ("Groupism"). 

14. Electronic Source When citing electronic sources, follow the same rules 
as for print sources, providing author names and page numbers, if available. 
If an author’s name is not given, use either the full title of the source in the 
text or a shortened version of the title in the parenthetical citation. (See item 
8 on page 643.) If no page numbers appear, include other identifying num- 
bers, such as paragraph or section numbers. (See item 3 on page 642.) 

Twenty million books were in print by the early sixteenth century (Rawlins, ch. 3, sec. 2). 

THE MLA LIST OF WORKS CITED 

A list of works cited provides the information your readers will need to find 
each source you have cited in the text. It should not include sources you 
consulted for background reading. Following are some guidelines for an MLA- 
style list of works cited. 

• Arranging entries. Arrange the entries alphabetically by the author’s 
last name. If two or more works are by the same author, arrange them 
alphabetically by title. Alphabetize works by an organization by the first 
significant word in the name of the organization. 
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• Book titles. Italicize titles of books and capitalize all major words. Note 
that in MLA style, prepositions are not capitalized. 

• Publication information. Shorten the publisher’s name where possible. 

For cities outside the United States, include the name of the province (in 
Canada) or country, abbreviated, unless the city is well known (such as 
Tokyo or London). 

• Periodical titles. Italicize titles of periodicals and capitalize all major words. 
Omit any initial article. 

• Article titles. Place titles of articles and other short works in quotation 
marks and capitalize all major words. 

• Electronic sources. Include as much information as you can about 
electronic sources, such as author, date of publication, identifying 
numbers, and retrieval information. Also, be sure to record the date 
you retrieved the information, because electronic information changes 
frequently. If no author is known, start with the title of the website. 
Italicize titles of entire websites; treat titles of works within websites, such 
as articles and video clips, as you would for print sources. In citations 

for online sources, include the sponsor or publisher, as well as the date 
of publication or update. If this information can’t be located, use N.p. 

(for No publisher) or n.d. (for no date). Insert the word Web before the date 
of retrieval. Include the URL only if you suspect that your reader will be 
unable to locate the source with a search engine. Place the URL in angle 
brackets at the end of the entry, after the date of retrieval. 

• Indenting. Use a hanging indent, with the first line of each entry flush with 
the left margin and all subsequent lines indented one-half inch. 

• Spacing. Double-space the entire works-cited list. Do not add extra space 
between entries. 

• Page numbers. Do not use the abbreviation p. or pp. when giving page 
numbers. For a range of pages, give only the last two digits of the second 
number if the previous digits are identical (for example, 243-47, not 
243-247 or 243-7). Use a plus sign (+) to indicate that an article continues 
on subsequent pages, interrupted by other articles or advertisements. 

• Dates. Follow the format day month year, with no commas (for example, 

20 Feb. 2009). Spell out May, June, and July; abbreviate all other months 
(except Sept.) using the first three letters followed by a period. 

• Medium. With a few exceptions explained below, list the medium of 
publication, followed by a period, as the last part of any entry. Examples 
include Print, Web, Radio, Television, CD, CD-ROM, Audiocassette, Film, 
Videocassette, DVD, Performance, Address, MS (for manuscript), TS (for 
typescript), E-mail, PDF/ile, Microsoft Word file, JPEG file, MP3 file. 

Following are models of works-cited-list entries for a variety of sources. 

For further examples of MLA-style citations, consult the MLA Handbookfor 

Writers of Research Papers. 
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MLA: CITING A BOOK BY ONE AUTHOR 


When citing a book, use the information from the title page and the copyright page (on the 
reverse side of the title page), not from the book's cover ora library catalog. 


NO PLACE 
TP i'HE 

U L Lb I V Iv 

GREENWALD 


©NO PLACE 

m H I D F 


EDWARD SNOWDEN, THE NSA. AND 
THE U.S. SURVEILLANCE STATE 


©GLENN GREENWALD 


Metropolitan Books 


Henry Holt 


New York 


0 


\ 


HlftOrOUMI BOOHS MtMNV NOLI HI* »0«» 


Qfl 


.VktropoiiUn Hooks 

Henry Holt and Company, LLC 

Publishers since 1866 


Copyright © 2014 by Glenn Greenwald 


Metropolitan Books* •< nd IS* ire repHm-d trademarks 
Henry Hok and Company, LLC. 


Copyright © 2014 by Glenn Greenwald 
All rights reserved. 




ISBN. 978 - 1 -6277*1-07 V4 
Library of Congress Control Number. 20M932SBS 

Henry Holt books are available fur special promotions and 
premiums For details contort Director. Special Markets. 


UntgneJ by Kelly X Too 

Printed In the United State* of America 
3579 I0S64 


From the book NO PLACE TO HIDE: Edward Snowden, the NSA, and the U.S. Surveillance State. Copyright © 2014 by Glenn Greenwald. Reprinted by permission of Henry Holt and 
Company, LLC. All rights reserved. 


Record the following information: 

A The author. Give the last name first, followed by a 

comma, the first name, and the middle initial (if given). D 

Don't include titles such as MD, PhD, or Sir; include 
suffixes after the name, preceded by a comma (Jones, 

Durham F., Jr.). End with a period. 

B The title. Give the full title; include the subtitle (if any), 

preceded by a colon. Italicize the title and subtitle, capi- E 

talizing all major words. End with a period. 

C The city of publication. If more than one city is given, 

use the first one listed. For a city outside the United F 

States that may be unfamiliar to your readers or con- 
fused with another city, add the abbreviation for the 


I © 1 | © 1 

Greenwald, Glen. No Place To Hide: Edward Snowden, the NSA, and the U.S. Surveillance State. 

I — ®HI © 

New York: Metropolitan-Henry Holt, 2014. Print. 


name of the province (in Canada) or country: London, 
ON; Plymouth, Eng. Follow this information with a colon. 

The publisher. Give a shortened version of the pub- 
lisher's name. If there is an imprint, give the name of the 
imprint and the publisher, connected with a hyphen. 

Do not include the word Press, Publisher, or Inc. Insert a 
comma. 

The date of publication. If more than one copyright 
date is given, use the most recent one. Use n.d. if no date 
is given. End with a period. 

The medium of publication. For a book, this would be 
Print. 


For more MLA-style models for citing other types of books, see pp. 647 and 648. 

n To watch a tutorial on citing books in MLA style, go to"Tutorials"under"Additional Resources"in Appendix, Part B: 

macmiilanhighered.com/launchpad/techcomm1 1 e. 
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BOOKS 

1 5. Book by One Author Include the author’s full name, in reverse order, 
followed by the book title. Next give the location and name of the publisher, 
followed by the year of publication and the medium. 

Gleick, James. The Information: A History, a Theory, a Flood. New York: Pantheon, 

2011. Print. 

1 6. Book by Multiple Authors For a book by two or three authors, present the 
names in the sequence in which they appear on the title page. Use reverse 
order for the name of the first author only. Use a comma to separate the 
names of the authors. 

Burt, Stephen, and David Mikics. The Art of the Sonnet. Cambridge: Belknap-Harvard 
UP, 2010. Print. 

For a book by four or more authors, either name all the authors or use the 
abbreviation et al. after the first author’s name. 

Thomas, David N., et al. The Biology of Polar Regions. Oxford: Oxford UP, 2008. 

Print. 

1 7. Multiple Books by the Same Author For the second and subsequent 
entries by the same author, use three hyphens followed by a period in 
place of the name. Arrange the entries alphabetically by title, ignoring An 
or The. 

Hassan, Robert. Empires of Speed: Time and the Acceleration of Politics and Society. 
Leiden: Brill, 2009. Print. 

— . The Information Society: Cyber Dreams and Digital Nightmares. Cambridge, Eng.: 
Polity, 2008. Print. 

1 8. Book Authored by an Organization The organization takes the position of 
the author. 

World Bank. Atlas of Global Development: A Visual Guide to the World's Greatest 
Challenges. Washington: World Bank, 2011. Print. 

1 9. Book by an Unknown Author If the author of the book is unknown, begin 
with the title. 

The World Almanac Notebook Atlas. Union: Hammond, 2010. Print. 

Note that you would ignore The in alphabetizing this entry. 

20. Edited Book List the book editor’s name, followed by ed. (or eds. if more 
than one editor), in place of the author’s name. 

Levi, Scott Cameron, and Ron Sela, eds. Islamic Central Asia: An Anthology of 
Historical Sources. Bloomington: Indiana UP, 2010. Print. 
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21 . Chapter or Section in an Edited Book Give the author and title of the 
article first, followed by the book title and editor. Present the editor’s name 
in normal order, preceded by Ed. (for Edited by). After the publication informa- 
tion, give the pages on which the material appears. 

Marx, Karl. "Proletarians and Communists." Marx Today: Selected Works and 
Recent Debates. Ed. John F. Sitton. New York: Palgrave-Macmillan, 2010. 

51-56. Print. 

22. Book in an Edition Other Than the First List the edition number after the 
title of the book. 

Geary, Patrick, ed. Readings in Medieval History. 4th ed. North York, ON: U of Toronto 
P, 2010. Print. 

23. Multivolume Work If you use two or more volumes from a multivolume 
work, indicate the total number of volumes (for example, 4 uols.) before the 
place of publication. If you use only one volume, give the volume number 
before the place of publication. Give the total number of volumes after the 
medium, if you wish. 

Sophocles. The Complete Sophocles. Ed. Peter Burian and Alan Shapiro. Vol. 1 . New 
York: Oxford UP, 2010. Print. 2 vols. 

24. Book That Is Part of a Series End the entry with the series name as it 
appears on the title page (but use common abbreviations, such as Ser.), fol- 
lowed by the series number, if any. Note that the series information follows 
the medium. 

Aune, David Edward, ed. The Blackwell Companion to the New Testament. Malden: 
Wiley-Blackwell, 2010. Print. Blackwell Companions to Religion. 

25. Translated Book After the title, present the translator’s name in normal 
order, preceded by Trans, (for Translated by). 

Torre, Domingo de la, Romin Teratol, and Antzelmo Peres. Travelers to the Other 
World: A Maya View of North America. Trans. Robert M. Laughlin. Ed. Carol Karasik. 
Albuquerque: U of New Mexico P, 2010. Print. 

26. Book in a Language Other Than English You may give a translation of the 
book’s title in brackets. 

Moine, Fabienne. Poesie et identite feminines en Angleterre: le genre en jeu, 1 830- 1 900 
[Poetry and Female Identity in England: Genre/Gender at Play], Paris: Harmattan, 

2010. Print. 

27. Entry in a Reference Work If the work is well known, you do not need to 
include the publisher or place of publication. If entries are listed alphabeti- 
cally, you do not need to include a page number. 

"Desdemona." Women in Shakespeare: A Dictionary. Ed. Alison Findlay. New York: 
Continuum, 2010. Print. 
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MLA: CITING AN ARTICLE FROM A PRINT PERIODICAL 


Periodicals include journals, magazines, and newspapers. This page gives an example of a 
citation for an article from a print journal. 


C] 


Vol. 2, No. 2 ❖ 03/201 1 


cco 


Interagency 
National Security Q 
Teams 

Can Social Science Contribute? 



O 

By James Douglas Orton with 
Christopher J. Lamb 


Record the following information: 

A The author. Give the last name first, followed by a 
comma, the first name, and the middle name or initial 
(if given). Don't include titles such as MD, PhD, or Sir; 
include suffixes after the name, preceded by a comma 
(Jones, Durham F., Jr.). End with a period. 

B The article title. Give the full title; include the subtitle (if 
any), preceded by a colon. Enclose the title in quotation 
marks, capitalizing all major words. Insert a period inside 
the closing quotation mark, unless the title includes its 
own punctuation. 

C The periodical title. Italicize the title. Omit any initial 
article and capitalize all major words. 

D The volume number and issue number. For journals, 
give the volume number, followed by a period (no 


space) and then the issue number. Give both volume 
and issue regardless of how the journal is paginated. 

E The date of publication. For journals, give the year in 
parentheses, followed by a colon. For monthly maga- 
zines, don't use parentheses; give the month and year. 
For weekly magazines and newspapers, don't use pa- 
rentheses; give the day, month, and year (in that order). 
Abbreviate the names of all months except May, June, 
and July. 

F Inclusive page numbers. For a range of page numbers 
1 00 and above, give only the last two digits of the sec- 
ond number if the previous digits are identical (for ex- 
ample, 243-47, not 243-247 or 243-7). Include section 
letters for newspapers, if relevant. End with a period. 

G The medium of publication. Print. 


I © 1 1 © 

Orton, James Douglas, and Christopher J. Lamb."lnteragency National Security Teams: Can Social 

ir®ii^r®nr®ir®j 

Science Contribute ?" Prism 2.2 (2011): 47-64. Print. 


For more MLA-style models for citing other types of periodical articles, see p. 650. 

■■■ To watch a tutorial on citing articles in MLA style, go to"Tutorials"under"Additional Resources"in Appendix, Part B: 

1 macmillanhighered.com/launchpad/techcomm11e. 
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PRINT PERIODICALS 

28. Journal Article List the author’s name, the article title (in quotation 
marks), and the journal title (italicized), followed by the volume number, 
issue number, year, page number(s), and medium. 

Mooney, William. "Sex, Booze, and the Code: Four Versions of the Maltese Falcon!' 
Literature-Film Quarterly 39.1 (201 1): 54-72. Print. 

29. Magazine Article List the author’s name, the article title (in quotation 
marks), and the magazine title (italicized), followed by the issue date, page 
number(s), and medium. 

Seabrook, John. "Crush Point." New Yorker 7 Feb. 201 1 : 32-38. Print. 

30. Newspaper Article List the author’s name, the article title (in quotation 
marks), and the newspaper name (italicized), followed by the issue date, page 
number(s) (which might include a section letter), and medium. If the news- 
paper appears in more than one edition, add a comma after the date and cite 
the edition (for example, late ed.). If sections are numbered, add a comma 
after the date, the word sec., and the section number. 

Robertson, Campbell. "Beyond the Oil Spill, theTragedy of an Ailing Gulf." New York 
Times 21 Apr. 201 1: A1 7. Print. 

31 . Unsigned Article If the author of an article is not indicated, begin with the 
title. Alphabetize the work by title, ignoring any initial article. 

"How Much Is Enough?" Economist 26 Feb. 201 1 : 5. Print. 

32. Article That Skips Pages Give the page on which the article starts, fol- 
lowed by a plus sign (+) and a period. 

Kennicott, Philip. "Out-Vermeering Vermeer." Washington Post 10 Apr. 201 1: El +. Print. 

33. Review For a book or film review, give the author of the review and the 
title of the review (in quotation marks), followed by the words Reu. of and the 
title of the work reviewed (italicized). Insert a comma and the word by, then 
give the name of the author of the work reviewed. (Instead of by, you might 
use ed., trans., or dir., depending on the work.) End with the publication infor- 
mation for the periodical in which the review was published. 

Wynne, Clive. "Our Conflicted Relationship with Animals." Rev. of Some We Love, Some 
We Hate, Some We Eat, by Hal Herzog. Nature 467.731 3 (2010): 275-76. Print. 

ELECTRONIC SOURCES 

34. Entire Website If you are citing an entire website, begin with the name of the 
author or editor (if given) and the title of the site (italicized). Then give the name 
of the sponsoring institution or organization (or N.p.), the date of publication or 
most recent update (or n.d.), the medium, and your access date. Only if neces- 
sary, add the URL in angle brackets at the end, followed by a period. 

Poets.org. Academy of American Poets, n.d. Web. 1 2 Jan. 2014. 
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MLA: CITING A SHORT WORK FROM A WEBSITE 


You will likely need to search the website to find some of the citation information you need. 
Always include the sponsor or publisher and the date of publication or most recent update. 



Record the following information: 

A The author. Give the last name first, followed by a 
comma, the first name, and the middle initial (if given). 
Don't include titles such as MD, PhD, or Sir; include 
suffixes after the name, preceded by a comma (Jones, 
Durham F., Jr.). End with a period. 

B The document title. Give the full title; include the 
subtitle (if any), preceded by a colon. Enclose the title 
in quotation marks, capitalizing all major words. Place a 
period inside the closing quotation mark, unless the title 
includes its own punctuation. 

C The title of the website. Italicize the title of the website. 
If there is no clear title and it is a personal home page, 
use Home page, not italicized. End with a period. 

D The name of the sponsoring organization. Look for 
the sponsor's name at the bottom of the home page. If 


you can't identify the sponsor or publisher, use N.p. End 
with a comma. 

E The date of publication or most recent update. Use 

the day, month, year format; abbreviate all months 
except May, June, and July. If you can't identify the date 
of publication or most recent update, use n.d. End with a 
period. 

F The medium of publication. Web. 

G The retrieval date. Give the most recent date you 
accessed the site. If there is little likelihood that your 
reader will be able to find the information using a search 
engine, give the complete URL, enclosed in angle brack- 
ets and followed by a period, after the date. If the URL is 
very long and complicated, however, give the URL of the 
site's search page instead. 


I ® 1| © 

Runco, Mario, Susan Runco, William L. Stefanov, and Brion Au. "We Can See Clearly Now: ISS Window 

1| 1| 

Observational Research Facility ." NASA Earth Observatory. National Aeronautics and Space 

® ® ® 

Administration, 4 Mar. 201 1. Web. 14 July 2011. 


For more MLA-style models for citing other types of web sources, see pp. 650, 652, and 654. 

n To watch a tutorial on citing websites in MLA style, go to "Tutorials" under "Additional Resources" in Appendix, Part B: 

macmillanhighered.com/launchpad/techcomm11e. 
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35. Short Work from a Website If you are citing a portion of a website, begin 
with the author, the title of the material (in quotation marks), and the title of 
the site (italicized). Then include the site’s sponsor, the date of publication, 
the medium, and your access date. 

Ferenstein, Greg. "How MobileTechnology Is a Game Changer for Developing 
Africa." Mashable. Mashable, 19 July 2010. Web. 14 Jan. 2011. 

36. Online Book Begin with the author’s name and the title of the work, along 
with publication information about the print source. If the book has not been 
published in print, include the online publication date and publisher. Include 
the medium. End with your access date. 

Martin-Palma, Raul J., and Akhlesh Lakhtakia. Nanotechnology: A Crash Course. 
Bellingham: SPIE, 2010. SPIE Digital Library. Web. 16 Jan. 201 1. 

37. Article in an Online Periodical Begin with the author’s name and include 
the title of the document, the name of the periodical, and the date of pub- 
lication. If the periodical is a scholarly journal, include relevant identifying 
numbers, such as volume, issue, and page numbers (or n. pa g. if there are 
no page numbers). For abstracts of articles, include the word Abstract, fol- 
lowed by a period, after the page number(s). End with the medium and your 
access date. 

Maas, Korey D. "Natural Law, Lutheranism, and the Public Good." Lutheran Witness 
130.3 (2011): n. pag. Web. 14 Jan. 2011. 

For magazine and newspaper articles found online, give the author, the title 
of the article (in quotation marks), the title of the magazine or newspaper 
(italicized), the sponsor or publisher of the site (use N.p. if there is none), the 
date of publication, the medium, and your date of access. 

Melia, Mike. "Atlantic Garbage Patch: Pacific Gyre Is Not Alone." Huffington Post. 
HuffingtonPost.com, 15 Apr. 2010. Web. 1 3 Feb. 201 1 . 

38. Article from a Database or Subscription Service After giving the print 
article information, give the name of the database (italicized), the medium 
(Web), and your access date. 

Kunnan, Anthony J. "Publishing in the Era of OnlineTechnologies." Modern 
Language Journal 94.4 (2010): 643-45. Academic OneFile. Web. 1 2 Feb. 201 1 . 

39. Dissertation The title appears in quotation marks if the dissertation is 
unpublished or in italics if it is published. 

Zimmer, Kenyon. The Whole World Is Our Country: Immigration and Anarchism in the 
United States, 1885-1940. Diss. Pittsburgh: U of Pittsburgh, 2010. Print. 

40. CD-ROM Treat material on a CD-ROM as you would if it were in print 
form. That is, if the source is an article in a database, include CD-ROM 
after the page numbers, followed by the database title, the vendor, and the 
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MLA: CITING AN ARTICLE FROM A DATABASE 


Libraries subscribe to services such as LexisNexis, ProQuest, InfoTrac, and EBSCOhost, which 
provide access to databases of electronic texts. 


0 

Searching: Academic Search Complete 

Q 

Effects of Empowerment on Performance 
in Open-Source Software Projects. 


Q 


Ke, Weiling 1 
Zhang, Ping 2 


IEEE Transactions on Engineering Management; 
05/01/201 1, Vol. 58 Issue 2, p334-346, 13p 


0 



Source: Ke and Zhang, 201 1 . 


Record the following information: 

A The author. Give the last name first, followed by a 
comma, the first name, and the middle initial (if given). 
Don't include titles such as MD, PhD, or Sir; include 
suffixes after the name, preceded by a comma (Jones, 
Durham F., Jr.). End with a period. 

B The article title. Give the full title; include the subtitle (if 
any), preceded by a colon. Enclose the title in quotation 
marks, capitalizing all major words. Place a period inside 
the closing quotation mark, unless the title includes its 
own punctuation. 

C The periodical title. Italicize the title. Omit any initial 
article, and capitalize all major words. 


D The volume number and issue number (if appropriate), 

E The date of publication. For journals, give the year in 
parentheses. For monthly magazines, don't use paren- 
theses; give the month and year. For weekly magazines 
and newspapers, don't use parentheses; give the day, 
month, and year (in that order). 

F Inclusive page numbers. If only the first page number 
is given, follow it with a plus sign and a period. 

G The name of the database. Italicize the name. 

H The medium of publication. Web. 

I The retrieval date. Use the day, month, year format. If 
necessary, add the URL, enclosed in angle brackets and 
followed by a period. 


I ® 1 | © 

Ke, Weiling, and Ping Zhang. "Effects of Empowerment on Performance in Open-Source Software 

ii ~ ® ir®ir®i r®nn®“~ 

Projects." IEEE Transactions on Engineering Management 58.2 (201 1 ): 334-46. Academic 

If©!! O 

Search Complete. Web. 1 0 May 201 1 . 


For more MLA-style models for citing other types of electronic sources, see pp. 652 and 654-56. 

n To watch a tutorial on citing articles from databases in MLA style, go to "Tutorials" under "Additional Resources" in Appendix, Part B: 

macmillanhighered.com/launchpad/techcomm1 1 e. 
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publication date of the database. If it is a book, treat it as a book, with CD- 
ROM as the medium. 

Greek-Cypriot Maritime Guide 201 1. Alimos, Greece: Marine Information Services, 

201 1. CD-ROM. 

41. Email Message Include the author’s name, the subject line (if any) in 
quotation marks, and then the words Message to followed by the name of the 
recipient (if you were the recipient, use the phrase the author). End with the 
date the email was sent and the medium (E-mail). 

Lange, Frauke. "Data for Genealogical Project." Message to the author. 26 Dec. 2010. 
E-mail. 

42. Online Posting List the author’s name, the subject line (if any) in quota- 
tion marks, the name of the discussion group or newsgroup in italics, the 
sponsor, the posting date, the medium (Web), and your access date. If there is 
no subject line, use the expression Online posting (not in quotation marks) in 
its place. 

Swallow, Bill. "Re: New Doc Group: FrameMaker or Flare?" TECHWR-L. RayComm, 5 
Jan. 2010. Web. 1 0 Feb. 2011. 

43. Other Online Sources Follow the MLA guidelines already discussed, 
adapting them as appropriate to the electronic medium. The following exam- 
ples are for a podcast and a blog, respectively. For a podcast, the medium 
might be Web, MP3 file, MPEG-4 file, Video file, and so on. If the blog doesn’t 
have a title (in quotation marks), use the expression Web log entry or Web log 
comment in its place, not in quotation marks. 

"Hubble Marks 20 Years of Discovery." NASACast Video. NASA, 23 Apr. 2010. Web. 1 5 
Jan. 2011. 

Raymo, Chet. "Divine Particulars." Sc/'ence Musings Blog. Chet Raymo, 21 Jan. 2011. 

Web. 15 Feb. 2011. 


OTHER SOURCES 

44. Government Document For a government publication, begin with the 
name of the country and the government agency. Follow with the document 
title. Then give the name of the author (if known), preceded by the word By. 
Follow with the report number or identifying number (if any), the location 
and name of the publisher, the date, and the medium. 

United States. National Commission on the Causes of the Financial and Economic 
Crisis. The Financial Crisis Inquiry Report: Final Report of the National Commission 
on the Causes of the Financial and Economic Crisis in the United States. 

Washington: GPO, 2011. Print. 

For an online source, follow the report number with the publisher or sponsor, 
the date of publication, the medium, and your date of access. 
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United States. Dept, of the Interior. A Refined Characterization of the Alluvial Geology 
of Yucca Flat and Its Effect on Bulk Hydraulic Conductivity. By G. A. Phelps, A. 

Boucher, and K. J. Halford. Open-File Report 2010-1 307. US Geological Survey, 

2011. Web. 12 Feb. 2011. 

45. Article from Conference Proceedings List the author’s name, the article 
title, the proceedings title, and the editor’s name, followed by the publication 
information and the medium. 

Glicksman, Robert. "Climate Change Adaptation and the Federal Lands." The Past, 
Present, and Future of Our Public Lands: Celebrating the 40th Anniversary of the 
Public Land Law Review Commission's Report. Ed. Gary C. Bryner. Boulder: Natural 
Resources Law Center, 2010. Print. 

46. Pamphlet Cite a pamphlet as you would a book. 

US Geological Survey. Facing Tomorrow's Challenges: An Overview. Denver: Habitat, 
2008. Print. 

47. Report Cite a report as you would a book. 

Liebreich, Michael, et al. Green Investing 2010: Policy Mechanisms to Bridge the 
Financing Gap. Geneva: World Economic Forum, 2010. Print. 

48. Interview For a published interview, begin with the name of the person 
interviewed. If the interview has a title, enclose it in quotation marks. Insert 
the word Interview and give the interviewer’s name, if relevant, followed by 

a period and the information on the work in which the interview was pub- 
lished. 

Walcott, Derek. "Purple Prose." Interview by Alexander Newbauer. Harper's 
Magazine Feb. 2010: 24-26. Print. 

If you conducted the interview yourself, give the interviewee’s name, the 
words Personal interview, and the date. 

Youngblood, Adelaide. Personal interview. 5 Jan. 201 1 . 

49. Letter or Memo If the letter or memo was addressed to you, give the writ- 
er’s name, the words Letter [or Memo] to the author, and the date it was written. 
End with the medium (e.g., MS for manuscript or TS for typescript). 

Jakobiak, Ursula. Letter to the author. 27 Oct. 2010. MS. 

If the letter or memo was addressed to someone other than you, give the 
recipient’s name in place of the words the author. 

50. Lecture or Speech Give the speaker’s name, the title of the lecture or 
speech (if known), the event and sponsoring organization (if applicable), and 
the place and date. End with the medium (such as Lecture or Keynote Speech). 

Wang, Samuel. "Neuroscience and Everyday Life." Freshman Assembly, Princeton 
University, Princeton, NJ. 1 2 Sept. 2010. Lecture. 
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51 . Map or Chart Give the author (if known), the title (in quotation marks), 
the word Map or Chart, the publication information, and the medium. For an 
online source, follow the word Map or Chart with the name of the website 
(italicized), the name of the site’s sponsor or publisher, the date of publica- 
tion, the medium, and the date of access. 

"Aftershock Map Tohoku Earthquake." Map. Earthquake Hazards Program. US 
Geological Survey, 1 1 Mar. 201 1 .Web. 14 Apr. 201 1. 

52. Photograph or Work of Art Give the name of the artist; the title of the 
artwork, italicized; the date of composition; the medium of composition; 
and the institution and city in which the artwork can be found. For artworks 
found online, omit the medium of composition and include the sponsor and 
the title of the website on which you found the work, the medium, and your 
date of access. 

Smedley, W.T. On the Beach at Narragansett Pier. 1900. Prints and Photographs Div., 
Lib. of Cong. Cabinet of American Illustration. Web. 1 5 Feb. 2011. 

53. Legal Source For a legal case, give the name of the first plaintiff and first 
defendant, the law report number, the name of the court, the year of the 
decision, publication information, the medium, and the date of access (if on 
the web). 

Natl. Assn, of Home Builders v. Defenders of Wildlife. No. 06-340. Supreme Court of 
the US. 2007. Supreme Court of the United States. Web. 1 2 Feb. 201 1. 

For a legislative act, give the name of the act, the Public Law number, the 
Statutes at Large volume and page numbers, the date the law was enacted, 
the medium, and the date of access. 

Protect America Act of 2007. Pub. L. 1 1 0-55. 5 Stat. 121-552. 5 Aug. 2007. Web. 15 
Feb. 2011. 

54. Radio or Television Program Give the title of the episode or segment, if 
applicable, and the title of the program. Include relevant information about 
the host, writer, director, or performers. Then give the network, call letters 
and city for the local station (if any), the broadcast date, and the medium. If 
you accessed the program on the web, instead of the original medium, give 
the title of the website, the medium (Web), and your date of access. 

"Aircraft Safety." Nightline. Narr. Cynthia McFadden. ABC. WCVB, Boston, 4 Apr. 201 1 . 
Television. 

"Petty Tyrant." This American Life. Host Ira Glass. Natl. Public Radio. WBEZ, Chicago, 

12 Nov. 2010. Radio. 

55. Film, Video, or DVD Give the title of the film and the name of the direc- 
tor. You may also give the names of major performers (Per/.) or the narrator 
(Narr.). Give the distributor, the year of the original release, and the medium 
(Film, DVD, or Videocassette ). 
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The King's Speech. Dir. Tom Hooper. Perf. Colin Firth, Geoffrey Rush, and Helena 
Bonham Carter. The Weinstein Co., 2010. Film. 

56. Advertisement Include the name of the product, organization, or service 
being advertised; the word Advertisement; and the publication information. 
If you accessed the advertisement online, give your access date after the 
medium (Web). 

NeutronicEar. Advertisement. Smithsonian Mar. 201 1 : 89. Print. 

SAMPLE MLA LIST OF WORKS CITED 

Following is a sample list of works cited using the MLA citation system. 


Works Cited 

Geary, Patrick, ed. Readings in Medieval History. 4th ed. North 
York, ON: U of Toronto P. 2010. Print. 

Kunnan, Anthony J. “Publishing in the Era of Online Technologies.”. — 
Modern Language Journal 94.4 (2010): 643 — 45. Academic OneFile. 
Web. 12 Feb. 2011. 

Marx, Karl. “Proletarians and Communists.” Marx Today: Selected 
Works and Recent Debates. Ed. John F. Sitton. New York: 
Palgrave-Macmillan, 2010. 51-56. Print. 

Melia, Mike. “Atlantic Garbage Patch: Pacific Gyre Is Not Alone.” 
Huffington Post. HuffingtonPost.com, 15 Apr. 2010. Web. 13 
Feb. 2011. 

Mooney, William. “Sex, Booze, and the Code: Four Versions of the 
Maltese Falcon.” Literature-Film Quarterly 39.1 (2011): 54-72. 

Print. 



Book in an edition other than the 
first 


Article from a database 


Chapter in an edited book 


Article in an online newspaper 


Journal article 
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Part C: Editing and Proofreading 
Your Documents 


This part of the handbook contains advice on editing your documents for 
grammar, punctuation, and mechanics. If your organization or professional 
field has a style guide with different recommendations about grammar and 
usage, you should of course follow those guidelines. 

Your instructor might use the following abbreviations to refer you to spe- 
cific topics in the text and in Parts C and D of this Appendix. 


Abbreviation 

Topic 

Page Number 

Abbreviation 

Topic 

Page Number 

abbr 

abbreviation 

673 

run 

run-on sentence 

218 

adj 

adjective (ESL) 

221,689 

sent 

sentence part (ESL) 

679 

adv 

adverb (ESL) 

690 

sub 

subordinating clause (ESL) 

681 

agr p/a 

pronoun-antecedent 

222 

t 

verb tense 

222 


agreement 


vb 

verb tense (ESL) 

682 

agr s/v 

subject-verb agreement (ESL) 

222, 686 


period 

664 

art 

article (a, an, the) (ESL) 

688 

i 

exclamation point 

664 

cap 

capitalization 

675 

? 

question mark 

664 

comp 

comparison of items 

220 

/ 

comma 

659 

cond 

conditional sentence (ESL) 

687 

/ 

semicolon 

662 

coor 

coordinating clause (ESL) 

681 

. 

colon 

663 

cs 

comma splice 

218 



dash 

664 

frag 

sentence fragment 

217 

0 

parentheses 

665 

help 

helping verb and main verb 
(ESL) 

685 

- 

hyphen 

670 

inf 

infinitive form of the verb 

684 

' 

apostrophe 

666 


(ESL) 



quotation marks 

667 

-ing 

-ing form of the verb (ESL) 

684 

. . . 

ellipses 

668 

ital 

italics (underlining) 

669 

< > 

angle brackets 

670 

num 

number 

671 

[] 

square brackets 

669 

omit 

omitted word or words (ESL) 

690 




ref 

ambiguous pronoun 
reference 

219 




rep 

repeated word (ESL) 

691 
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Punctuation 


> COMMAS 

The comma is the most frequently used punctuation mark, as well as the 
one about whose usage writers most often disagree. Examples of common 
misuses of the comma accompany the following guidelines. The section con- 
cludes with advice about editing for unnecessary commas. 

1. Use a comma in a compound sentence to separate two independent 
clauses linked by a coordinating conjunction (and, or, nor, but, s o, for, or yet). 

incorrect The mixture was prepared from the two premixes and the remaining 
ingredients were then combined. 

correct The mixture was prepared from the two premixes, and the remaining 
ingredients were then combined. 

2. Use a comma to separate items in a series composed of three or more 
elements. 

The manager of spare parts is responsible for ordering, stocking, and disbursing 
all spare parts for the entire plant. 

Despite the presence of the conjunction and, most technical- 
communication style manuals require a comma after the second-to-last 
item. The comma clarifies the separation and prevents misreading. 

confusing The report will be distributed to Operations, Research and 
Development and Accounting. 

clear The report will be distributed to Operations, Research and 

Development, and Accounting. 

3. Use a comma to separate introductory words, phrases, and clauses from 
the main clause of the sentence. 

However, we will have to calculate the effect of the wind. 

To facilitate trade, the government holds a yearly international conference. 

In the following example, the comma actually prevents misreading: 

Just as we finished eating, the rats discovered the treadmill. 

NOTE: Writers sometimes make errors by omitting commas following 
introductory words, phrases, or clauses. A comma is optional only if the 
introductory text is brief and cannot be misread. 

correct First, let's take care of the introductions. 
correct First let's take care of the introductions. 

incorrect As the researchers sat down to eat the laboratory rats awakened. 

As the researchers sat down to eat, the laboratory rats awakened. 


CORRECT 
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For more about restrictive and 
nonrestrictive modifiers, see Ch. 10, 

p. 228. 


For more about coordinate 
adjectives, see Ch. 10, p. 221. 


4. Use a comma to separate a dependent clause from the main clause. 

Although most of the executive council saw nothing wrong with it, the 
advertising campaign was canceled. 

Most tablet computers use green technology, even though it is relatively 
expensive. 

5. Use commas to separate nonrestrictive modifiers (parenthetical clarifica- 
tions) from the rest of the sentence. 

Jones, the temporary chairman, called the meeting to order. 

NOTE: Writers sometimes introduce an error by dropping one of the 
commas around a nonrestrictive modifier. 

incorrect The data line, which was installed two weeks ago had to be 
disconnected. 

correct The data line, which was installed two weeks ago, had to be 
disconnected. 

6. Use a comma to separate interjections and transitional elements from 
the rest of the sentence. 

Yes, I admit that your findings are correct. 

Their plans, however, have great potential. 

NOTE: Writers sometimes introduce an error by dropping one of the 
commas around an interjection or a transitional element. 

incorrect Our new statistician, however used to work for Konaire, Inc. 
correct Our new statistician, however, used to work for Konaire, Inc. 

7. Use a comma to separate coordinate adjectives. 

The finished product was a sleek, comfortable cruiser. 

The heavy, awkward trains are still being used. 

The commas in these examples take the place of the conjunction and. 

If the adjectives are not coordinate — that is, if one of the adjectives 
modifies the combined adjective and noun — do not use a comma: 

They decided to go to the first general meeting. 

8. Use a comma to signal that a word or phrase has been omitted from a 
sentence because it is implied. 

Smithers is in charge of the accounting; Harlen, the data management; Demarest, 
the publicity. 

The commas after Harlen and Demarest show that the phrase is in charge of has 
not been repeated. 

9. Use a comma to separate a proper noun from the rest of the sentence in 
direct address. 
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John, have you seen the purchase order from United? 

What I'd like to know, Betty, is why we didn't see this problem coming. 

10. Use a comma to introduce most quotations. 

He asked, "What time were they expected?" 

11. Use a comma to separate cities or towns, states, and countries. 

Bethlehem, Pennsylvania, is the home of Lehigh University. 

He attended Lehigh University in Bethlehem, Pennsylvania, and the University of 
California at Berkeley. 

Note that a comma precedes and follows Pennsylvania. 

12. Use a comma to set off the year in a date. 

August 1 , 201 2, is the anticipated completion date. 

If the month separates the date and the year, you do not need to use 
commas because the numbers are not next to each other: 

The anticipated completion date is 1 August 2012. 

13. Use a comma to clarify numbers. 

12,013,104 

NOTE: European practice is to reverse the use of commas and periods in 
writing numbers: periods separate hundreds and thousands, thousands 
and millions, and so on, while commas separate whole numbers from 
decimals. 

12.013,4 

14. Use a comma to separate names from professional or academic titles. 

Harold Clayton, PhD 
Marion Fewick, CLU 
Joyce Carnone, PE 

The comma also follows the title in a sentence: 

Harold Clayton, PhD, is the featured speaker. 


For more about comma splices, see 
Ch. 10, p. 218. 


Unnecessary Commas 

Writers often introduce errors by using unnecessary commas. Do not insert 
commas in the following situations: 

• Commas are not used to link two independent clauses without a 
coordinating conjunction (an error known as a “comma splice”). 

incorrect All the motors were cleaned and dried after the water had entered, had 
they not been, additional damage would have occurred. 

All the motors were cleaned and dried after the water had entered; had 
they not been, additional damage would have occurred. 


CORRECT 


REFERENCE HANDBOOK 


correct All the motors were cleaned and dried after the water had entered. Had 
they not been, additional damage would have occurred. 

• Commas are not used to separate the subject from the verb in a sentence. 

incorrect Another of the many possibilities, is to use a "first in, first out" 
sequence. 

correct Another of the many possibilities is to use a "first in, first out" 
sequence. 

• Commas are not used to separate the verb from its complement. 

incorrect The schedules that have to be updated every month are, numbers 1 4, 
16, 21,22, 27, and 31. 

correct The schedules that have to be updated every month are numbers 14, 
16, 21,22, 27, and 31. 

• Commas are not used with a restrictive modifier. 

incorrect New and old employees, who use the processed order form, do not 
completely understand the basis of the system. 

The phrase who use the processed order form is a restrictive modifier 
necessary to the meaning: it defines which employees do not 
understand the system. 

correct New and old employees who use the processed order form do not 
completely understand the basis of the system. 

incorrect A company, that has grown so big, no longer finds an informal 
evaluation procedure effective. 

The clause that has grown so big is a restrictive modifier. 

correct A company that has grown so big no longer finds an informal 
evaluation procedure effective. 

• Commas are not used to separate two elements in a compound subject. 

incorrect Recent studies, and reports by other firms confirm our experience. 

correct Recent studies and reports by other firms confirm our experience. 


; SEMICOLONS 

Semicolons are used in the following instances: 

1. Use a semicolon to separate independent clauses not linked by a coordi- 
nating conjunction. 

The second edition of the handbook is more up-to-date; however, it is also more 
expensive. 

2. Use a semicolon to separate items in a series that already contains commas. 

The members elected three officers: Jack Resnick, president; Carol Wayshum, vice 
president; Ahmed Jamoogian, recording secretary. 
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Here the semicolon acts as a “supercomma,” grouping each name with the 
correct title. 

Misuse of Semicolons 

Sometimes writers incorrectly use a semicolon when a colon is called for: 

incorrect We still need one ingredient; luck. 
correct We still need one ingredient: luck. 


COLONS 

Colons are used in the following instances: 

1. Use a colon to introduce a word, phrase, or clause that amplifies, illus- 
trates, or explains a general statement. 

The project team lacked one crucial member: a project leader. 

Here is the client's request: we are to provide the preliminary proposal by 
November 13. 

We found three substances in excessive quantities: potassium, cyanide, and 
asbestos. 

The week was productive: 1 4 projects were completed, and another dozen were 
initiated. 

NOTE: The text preceding a colon should be able to stand on its own as a 
sentence: 

incorrect We found: potassium, cyanide, and asbestos. 

correct We found the following: potassium, cyanide, and asbestos. 

correct We found potassium, cyanide, and asbestos. 

2. Use a colon to introduce items in a vertical list if the sense of the intro- 
ductory text would be incomplete without the list. 

We found the following: 

• potassium 

• cyanide 

• asbestos 

3. Use a colon to introduce long or formal quotations. 

The president began: "In the last year 

Misuse of Colons 

Writers sometimes incorrectly use a colon to separate a verb from its 
complement: 

incorrect The tools we need are: a plane, a level, and a T square. 
correct The tools we need are a plane, a level, and a T square. 
correct We need three tools: a plane, a level, and aT square. 


For more about constructing lists, see 
Ch.9,pp. 198-204. 
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For more about abbreviations, see 
page 673. 


PERIODS 

Periods are used in the following instances: 

1. Use a period at the end of sentences that do not ask questions or 
express strong emotion. 

The lateral stress still needs to be calculated. 

2. Use a period after some abbreviations. 

U.S.A. 

etc. 

3. Use a period with decimal fractions. 

4.056 

$6.75 

75.6 percent 


! EXCLAMATION POINTS 

The exclamation point is used at the end of a sentence that expresses strong 
emotion, such as surprise. 

The nuclear plant, which was originally expected to cost $1.6 billion, eventually cost 
more than $8 billion! 

In technical documents, which require objectivity and a calm, understated 
tone, exclamation points are rarely used. 


QUESTION MARKS 

The question mark is used at the end of a sentence that asks a direct question. 

What did the commission say about effluents? 

NOTE: When a question mark is used within quotation marks, no other end 
punctuation is required. 


She asked, "What did the commission say about effluents?" 


Misuse of Question Marks 

Do not use a question mark at the end of a sentence that asks an indirect 
question. 

He wanted to know whether the procedure had been approved for use. 


DASHES 


To make a dash, use two uninterrupted hyphens ( — ). Do not add a space 
before or after the dash. Some word-processing programs turn two hyphens 
into a dash, but with others, you have to use a special combination of keys to 
make a dash; there is no dash key on the keyboard. 

Dashes are used in the following instances: 
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1. Use a dash to set off a sudden change in thought or tone. 

The committee found — can you believe this? — that the company bore full 
responsibility for the accident. 

That's what she said — if I remember correctly. 

2. Use a dash to emphasize a parenthetical element. 

The managers' reports — all 10 of them — recommend production cutbacks for the 
coming year. 

Arlene Kregman — the first woman elected to the board of directors — is the next 
scheduled speaker. 

3. Use a dash to set off an introductory series from its explanation. 

Wet suits, weight belts, tanks — everything will have to be shipped in. 

NOTE: When a series follows the general statement, a colon replaces the 
dash. 

Everything will have to be shipped in: wet suits, weight belts, and tanks. 


Misuse of dashes 

Sometimes writers incorrectly use a dash as a substitute for other punctua- 
tion marks: 

incorrect The regulations — which were issued yesterday — had been anticipated 
for months. 

There would be no reason to emphasize this parenthetical element. 

correct The regulations, which were issued yesterday, had been anticipated for 
months. 


incorrect Many candidates applied — however, only one was chosen. 
correct Many candidates applied; however, only one was chosen. 


0 


PARENTHESES 


Parentheses are used in the following instances: 


1. Use parentheses to set off incidental information. 

Please call me (x3104) when you get the information. 

Galileo (1 564-1 642) is often considered the father of modern astronomy. 

The cure rate for lung cancer almost doubled in thirty years (Capron, 201 2). 

2. Use parentheses to enclose numbers and letters that label items listed 
in a sentence. 

To transfer a call within the office, (1) place the party on HOLD, (2) press 
TRANSFER, (3) press the extension number, and (4) hang up. 

Use both a left and a right parenthesis — not just a right parenthesis — in 
this situation. 
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For more about square brackets, see 
p. 669. 


Misuse of Parentheses 

Sometimes writers incorrectly use parentheses instead of brackets to enclose 
their insertion within a quotation: 

incorrect He said, "The new manager (Farnham) is due in next week." 
correct He said, "The new manager [Farnham] is due in next week." 

’ APOSTROPHES 

Apostrophes are used in the following instances: 

1. Use an apostrophe to indicate possession. 

the manager's goals the employees' credit union 
the workers' lounge Charles's T square 

For joint possession, add an apostrophe and an s only to the last noun or 
proper noun: 

Watson and Crick's discovery 

For separate possession, add an apostrophe and an s to each of the 
nouns or pronouns: 

Newton's and Galileo's theories 

NOTE: Do not add an apostrophe or an s to possessive pronouns: his, hers, 
its, ours, yours, theirs. 

2. Use an apostrophe to indicate possession when a noun modifies a 
gerund. 

We were all looking forward to Bill's joining the company. 

The gerund joining is modified by the proper noun Bill. 

3. Use an apostrophe to form contractions. 

I've shouldn't 
can't it's 

The apostrophe usually indicates an omitted letter or letters: 

can(no)t = can't 
it (i)s = it's 

NOTE: Some organizations discourage the use of contractions. Find out 
what the policy of your organization is. 

4. Use an apostrophe to indicate special plurals. 

three 9's 

two different JCL's 

the why's and how's of the problem 
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NOTE: For plurals of numbers and abbreviations, some style guides omit 
the apostrophe: 9s, JCLs. Because usage varies considerably, check with 
your organization. 

Misuse of Apostrophes 

Writers sometimes incorrectly use the contraction it's in place of the posses- 
sive pronoun its. 

incorrect The company's management does not believe that the problem is it's 
responsibility. 

correct The company's management does not believe that the problem is its 
responsibility. 

“ ” QUOTATION MARKS 

Quotation marks are used in the following instances: 

1. Use quotation marks to indicate titles of short works, such as articles, 
essays, or chapters. 

Smith's essay "Solar Heating Alternatives" was short but informative. 

2. Use quotation marks to call attention to a word or phrase used in an 
unusual way or in an unusual context. 

A proposal is "wired" if the sponsoring agency has already decided who will be 
granted the contract. 

NOTE: Do not use quotation marks to excuse poor word choice: 
incorrect The new director has been a real "pain." 

3. Use quotation marks to indicate a direct quotation. For more about quoting sources, see 

Appendix, Part A, p. 609. 

"In the future," he said, "check with me before authorizing any large purchases." 

As Breyer wrote, "Morale is productivity." 

NOTE: Quotation marks are not used with indirect quotations: 

incorrect He said that "third-quarter profits will be up." 
correct He said that third-quarter profits will be up. 
correct He said, "Third-quarter profits will be up." 

Also note that quotation marks are not used with quotations that are longer 
than four lines; instead, set the quotation in block format. In a word-processed 
manuscript, a block quotation is usually introduced by a complete sentence 
followed by a colon and indented one-half inch from the left-hand margin. 

Different style manuals recommend variations on the basic rules; the fol- 
lowing example illustrates APA style. 

McFarland (201 1) writes: 

The extent to which organisms adapt to their environment is still being charted. 

Many animals, we have recently learned, respond to a dry winter with an 




REFERENCE HANDBOOK 


668 


automatic birth control chemical that limits the number of young to be born that 
spring. This prevents mass starvation among the species in that locale, (p. 49} 
Hollins (2012) concurs. She writes, "Biological adaptation will be a major research 
area during the next decade" (p. 2). 

Using Quotation Marks with Other Punctuation 

• If the sentence contains a tag — a phrase identifying the speaker or 
writer — a comma separates it from the quotation: 

Wilson replied, "I'll try to fly out there tomorrow." 

"I'll try to fly out there tomorrow, "Wilson replied. 

Informal and brief quotations require no punctuation before a quotation 
mark: 

She asked herself "Why?" several times a day. 

• In the United States (unlike most other nations where English is spoken), 
commas and periods following quotations are placed within the quotation 
marks: 

The project engineer reported, "A new factor has been added." 

"A new factor has been added," the project engineer reported. 

• Question marks, dashes, and exclamation points are placed inside 
quotation marks when they are part of the quoted material: 

He asked, "Did the shipment come in yet?" 

• When question marks, dashes, and exclamation points apply to the whole 
sentence, they are placed outside the quotation marks: 

Did he say, "This is the limit"? 

• When a punctuation mark appears inside a quotation mark at the end of a 
sentence, do not add another punctuation mark: 

incorrect Did she say, "What time is it?"? 
correct Did she say, "What time is it?" 

... ELLIPSES 

Ellipses (three spaced periods) indicate the omission of material from a direct 
quotation. 

source My team will need three extra months for market research and quality- 
assurance testing to successfully complete the job. 
quote She responded, "My team will need three extra months ... to 

successfully complete the job." 
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Insert an ellipsis after a period if you are omitting entire sentences that follow: 

Larkin refers to the project as "an attempt ... to clarify the issue of compulsory 

arbitration We do not foresee an end to the legal wrangling . . . but perhaps the 

report can serve as a definition of the areas of contention." 

The writer has omitted words from the source after attempt and after wrangling. 
After arbitration, the writer has inserted an ellipsis after a period to indicate that a 
sentence has been omitted. 

NOTE: If the author’s original statement has ellipses, MLA style recommends 
that you insert brackets around an ellipsis that you introduce in a quotation. 

Sexton thinks "reuse adoption offers . . . the promise to improve business [. . .] 
worldwide." 


[] 


SQUARE BRACKETS 


Square brackets are used in the following instances: 


1. Use square brackets around words added to a quotation. 

As noted in the minutes of the meeting, "He [Pearson] spoke out against the 
proposal." 

A better approach would be to shorten the quotation: 

The minutes of the meeting note that Pearson "spoke out against the 
proposal." 

2. Use square brackets to indicate parenthetical information within 
parentheses. 

(For further information, see Charles Houghton's Civil Engineering Today 
[ 1997 ].) 


Mechanics 
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ITALICS 


Although italics are generally preferred, you may use underlining in place of 
italics. Whichever method you choose, be consistent throughout your docu- 
ment. Italics (or underlining) are used in the following instances: 


1. Use italics for words used as words. 


ital 
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In this report, the word operator will refer to any individual who is in charge of 
the equipment, regardless of that individual's certification. 
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2. Use italics to indicate titles of long works (books, manuals, and so on), peri- 
odicals and newspapers, long films, long plays, and long musical works. 

See Houghton's Civil Engineering Today. 

We subscribe to the Wall Street Journal. 

Note that the is not italicized or capitalized when the title is used in a sentence. 

NOTE: The MLA style guide recommends that the names of websites be 
italicized. 

The Library of Congress maintains Thomas, an excellent site for legislative 
information. 

3. Use italics to indicate the names of ships, trains, and airplanes. 

The shipment is expected to arrive next week on the Penguin. 

4. Use italics to set off foreign expressions that have not become fully 
assimilated into English. 

Grace's joiede vivre makes her an engaging presenter. 

Check a dictionary to determine whether a foreign expression has 
become assimilated. 

5. Use italics to emphasize words or phrases. 

Do not press the red button. 


< > 


ANGLE BRACKETS 


Some style guides advocate using angle brackets around URLs in print docu- 
ments to set them off from the text. 


Our survey included a close look at three online news sites: the New York Times <www 
.nytimes.com>, the Washington Post <www.washingtonpost.com>, and CNN <www 
.cnn.com>. 


You may want to check with your instructor or organization before following 
this recommendation. 


HYPHENS 

Hyphens are used in the following instances: 

1. Use hyphens to form compound adjectives that precede nouns. 

general-purpose register 
meat-eating dinosaur 
chain-driven saw 

NOTE: Hyphens are not used after adverbs that end in -ly. 
newly acquired terminal 
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Also note that hyphens are not used when the compound adjective 
follows the noun: 

The Woodchuck saw is chain driven. 

Many organizations have their own policy about hyphenating compound For more about compound 

adjectives. Check to see if your organization has a policy. adjectives, seepp. 221-22. 

2. Use hyphens to form some compound nouns. 

once-over 

go-between 

NOTE: There is a trend away from hyphenating compound nouns (uice 
president, photomicroscope, drawbridge ); check your dictionary for proper 
spelling. 

3. Use hyphens to form fractions and compound numbers. 

one-half 

fifty-six 

4. Use hyphens to attach some prefixes and suffixes. 

post-1945 

president-elect 

5. Use hyphens to divide a word at the end of a line. 

We will meet in the pavil- 
ion in one hour. 

Whenever possible, however, avoid such line breaks; they slow the reader 
down. Even when your word processor is determining the line breaks, 
you may have to check the dictionary occasionally to make sure a word 
has been divided between syllables. If you need to break a URL at the 
end of a line, do not add a hyphen. Instead, break the URL before a single 
slash or before a period: 

<http://www.stc.org 

/ethical.asp> 


num 


NUMBERS 


Ways of handling numbers vary considerably. Therefore, in choosing between 
words and numerals, consult your organization’s style guide. Many organiza- 
tions observe the following guidelines: 


1. Technical quantities of any size are expressed in numerals, especially if 
a unit of measurement is included. 


3 feet 43,219 square miles 

1 2 grams 36 hectares 
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2. Nontechnical quantities of fewer than 10 are expressed in words. 

three persons 
six whales 

3. Nontechnical quantities of 10 or more are expressed in numerals. 

300 persons 
12 whales 

4. Approximations are written out. 

approximately ten thousand people 
about two million trees 

5. Round numbers over nine million are expressed in a combination of 
words and numerals. 

14 million light-years 
$64 billion 

6. Decimals are expressed in numerals. 

3.14 

1,013.065 

Decimals of less than one should be preceded by a zero: 

0.146 

0.006 

7. Fractions are written out, unless they are linked to units of measurement. 

two-thirds of the members 
31/2 hp 

8. Time of day is expressed in numerals if a.m. or p.m. is used; otherwise, it 
is written out. 

6:1 0 a.m. 

six o'clock 

the nine-thirty train 

9. Page numbers and figure and table numbers are expressed in numerals. 

Figure 1 
Table 13 
page 261 

10. Back-to-back numbers are written using a combination of words and 
numerals. 

six 3-inch screws 
fourteen 12-foot ladders 
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3,01 2 five-piece starter units 

In general, the quantity linked to a unit of measurement should 
be expressed with the numeral. If the nontechnical quantity would be 
cumbersome in words, however, use the numeral for it instead. 

11. Numbers in legal contracts or in documents intended for international 
readers should be represented in both words and numerals. 

thirty-seven thousand dollars ($37,000) 
five (5) relays 

12. Street addresses may require both words and numerals. 

3801 Fifteenth Street 


Special Cases 

• A number at the beginning of a sentence should be spelled out: 

Thirty-seven acres was the size of the lot. 

Many writers would revise the sentence to avoid spelling out the 
number: 

The lot was 37 acres. 

• Within a sentence, numbers with the same unit of measurement should 
be expressed consistently in either numerals or words: 

incorrect On Tuesday, the attendance was 1 3; on Wednesday, eight. 
correct On Tuesday, the attendance was 1 3; on Wednesday, 8. 

correct On Tuesday, the attendance was thirteen; on Wednesday, eight. 

• In general, months should not be expressed as numbers. In the United 
States, 3/7/15 means March 7, 2015; in many other countries, it means 
July 3, 2015. The following forms, in which the months are written out, 
are preferable: 

March 7,2015 
7 March 2015 
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ABBREVIATIONS 


Abbreviations save time and space, but you should use them carefully 
because your readers may not understand them. Many companies and pro- 
fessional organizations provide lists of approved abbreviations. 

Analyze your audience to determine whether and how to abbreviate. If 
your readers include a general audience unfamiliar with your field, either 
write out the technical terms or attach a list of abbreviations. If you are new 
to an organization or are publishing in a field for the first time, find out which 
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abbreviations are commonly used. If for any reason you are unsure about a 
term, write it out. 

The following are general guidelines about abbreviations: 

1. When an unfamiliar abbreviation is introduced for the first time, the 
full term should be given, followed by the abbreviation in parentheses. 
In subsequent references, the abbreviation may be used alone. For long 
works, the full term and its abbreviation may be written out at the start 
of major units, such as chapters. 

The heart of the new system is the self-loading cartridge (SLC). 

The liquid crystal display (LCD) is your control center. 

2. To form the plural of an abbreviation, an s is added, either with or with- 
out an apostrophe, depending on the style used by your organization. 

GNP's or GNPs 
PhD's or PhDs 

Abbreviations for most units of measurement do not take plurals: 

10 in. 

3 qt 

3. Most abbreviations in scientific writing are not followed by 
periods. 

lb 

cos 

dc 

If an abbreviation can be confused with another word, however, a period 
should be used: 

in. 

Fig. 

4. If no number is used with a unit of measurement, an abbreviation 
should not be used. 

incorrect How many sq meters is the site? 

How many square meters is the site? 


CORRECT 
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cap 


CAPITALIZATION 


For the most part, the conventions of capitalization in general writing apply 
in technical communication: 


1. Proper nouns, titles, trade names, places, languages, religions, and orga- 
nizations should be capitalized. 

William Rusham 
Director of Personnel 
Quick-Fix Erasers 
Bethesda, Maryland 
Italian 
Methodism 

Society for Technical Communication 

In some organizations, job titles are not capitalized unless they refer to 
specific people. 

Alfred Loggins, Director of Personnel, is interested in being considered for vice 
president of marketing. 

2. Headings and labels should be capitalized. 

A Proposal To Implement the Wilkins Conversion System 

Mitosis 

Table 3 

Section One 

The Problem 

Rate of Inflation, 2002-201 2 
Figure 6 
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Proofreading Symbols and Their Meanings 


MARKIN MARGIN 

INSTRUCTIONS 

MARK ON MANUSCRIPT 

CORRECTED TYPE 

JL/ 

Delete 

$10 billion dollai r 3 >< ' 

$10 billion 

A 

Insert 

environment 

environment 

$52) 

Let stand 

lefft stand 

let it stand 

<&£) 

Capitalize 

the^english language 

the English language 

(£) 

Make lowercase 

the English^anguage 

the English language 

, 

Italicize 

Technical Communication 

Technical Communication 

@) 

Transpose 

reiftkve 

receive 


Close up space 

diagnostic ultrasound 

diagnostic ultrasound 


Spell out 

(PreSp Smithers 

President Smithers 

# 

Insert space 

|amp light 

3 amp light 

f 

Start paragraph 

... the result^ These results 

... the results. 
These results 

run in 

No paragraph 

... the results^ 
^For this reason, 

... the results. For this reason, 


Set in small capitals 

Needle-nose pliers 

NEEDLE-NOSE PLIERS 

(§) 

Set in boldface 

Needlemose^liem 

Needle-nose pliers 


Insert period 

Fi<fc21 

Fig. 21 


Insert comma 

the plant which was built 

the plant, which was built 

= 

Insert hyphen 

menirdriven software 

menu-driven software 

© 

Insert colon 

Add the following^ 

Add the following: 

> 

Insert semicolon 

... the plan^however, the committee 

... the plan; however, the committee 


Insert apostrophe 

the users preference 

the user’s preference 


Insert quotation marks 

$ Furthermore^ she said . . . 

“Furthermore,” she said . . . 

*/> 

Insert parentheses 

Write to us^kt the Newark offic^ 

Write to us (at the Newark office) 

0 

Insert brackets 

President[joh[] Smithers 

President [John] Smithers 

_jr_ 

Insert en dash 

1984-2001 

H 

1984-2001 

_U 

Insert em dash 

Our goalWictory 

Our goal — victory 


Insert superscript 

4,000 ft£ 

4,000 ft 2 

❖ 

Insert subscript 

h5o 

h 2 o 

// 

Align 

$123.05// 

$123.05 


$86.95/7 

$86.95 

r 

Move to the left 

["PVC piping 

PVC piping 

"i 

J 

Move to the right 

PVC~piplng] 

PVC piping 

r — i 

Move up 

fpvcloipingl 

PVC piping 

U— 1 

Move down 

^PVC piping) 

PVC piping 
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Cultural and Stylistic Communication Issues 

Just as native speakers of English must learn how to communicate with non- 
native speakers of English in the United States and abroad, technical com- 
municators whose first language is not English must learn how to communi- 
cate with native speakers in the United States. 

If you want to communicate effectively with native speakers, you need 
to understand U.S. culture. Specifically, you need to understand how U.S. 
readers expect writers to select, organize, and present information and what 
writers expect from their readers. Speakers and listeners in the United States 
also have expectations. Indeed, cultural values affect all styles of communi- 
cation. Of course, no two communicators are exactly alike. Still, if you know 
how culture affects Western communicators in general, you can analyze your 
communication task and communicate effectively. 

Readers, writers, speakers, and listeners in the United States value the fol- 
lowing qualities: 

• Directness. Audiences in the United States expect writers and speakers 
to get to the point quickly and to communicate information clearly. So 
when you write a claim letter, for example, clearly state what you want 
the individual you are addressing to do to correct the situation. Related 
to directness is task orientation. Do not begin a letter with a comment 
about the weather or family. Instead, communicate immediately about 
business. 

• Independence. In spite of the increasingly significant role of collaborative 
writing, U.S. audiences still value individualism and people who can 
work independently. Therefore, when you write a letter to an individual 
in an organization, be aware that the recipient sees you as one person, 
too, not merely as a mouthpiece of an organization. Use the pronoun I 
rather than we. 

• Time consciousness. Try to meet deadlines and to arrive on time for 
appointments. Audiences in the United States consider slowness in 
responding to issues a sign of disrespect. 

To become familiar with the U.S. style of communication, study docu- 
ments, talk to people, and ask for feedback from U.S. readers and listeners. 
Following are some specific guidelines for applying the preceding general 
cultural values as you listen, speak, and write to U.S. audiences. 


For more about communicating 
across cultures, see Ch. 5, pp. 95- 1 04. 


For more about claim letters, see Ch. 
14, p. 366. 


For more about writing 
collaboratively, see Ch. 4. 
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For more about claims, see Ch. 8, p. 
1 76. For more about introductions, 
seeCh. 19, p. 518. 


LISTENING 

Speakers in the United States expect you, their audience, to listen actively. 

They assume that you will ask questions and challenge their points — but not 

interrupt them unless you are invited to do so. To become a better listener, 

try the following strategies: 

• Look at the speaker's eyes or at least at the speaker's face. Lean forward 
or nod your head to encourage the speaker. If you avoid looking at the 
speaker, he or she could think that you are not interested in the message. 

• Do not interrupt the speaker. Interrupting shows the speaker that you do 
not value his or her opinion. Give the speaker enough time to complete his 
or her presentation. 

• Do not become indignant. Be prepared to hear the speaker state clearly 
what he or she likes and dislikes, often without considering other people’s 
personal feelings. 

• Assume that the speaker values your opinion. Form responses and, at the 
appropriate time, express your opinions openly. 

• Ask questions. If you have questions, ask them. If you do not ask questions, 
the speaker might assume that you not only understand but also agree 
with the message of the presentation. It is altogether appropriate to ask 
questions such as these: “Do you mean . . .?" “Did I understand you to 

say ... ?” “Would you repeat . . . ?” 


SPEAKING 

As suggested in Chapter 21, U.S. audiences expect speakers to control the 
situation, keep listeners interested, address listeners directly, and speak with 
authority. Do not apologize for your fluency or for problems in your content. 
Doing so could diminish your credibility and make listeners think you are 
wasting their time. To become a better speaker, try the following strategies: 

• Start and end your presentation on time. If you start late or speak too long, 
you send the message “Your time is less valuable than mine.” 

• Make eye contact and smile. If you make eye contact with people, you look 
friendly and confident, and you send the message “You are important.” 

• Speak up. If you speak with your head bowed or in too low a voice, 
audience members could become distracted or think you are hiding 
something. 

• Make friendly gestures. Invite the audience to ask questions. It is appropriate 
to say “Please feel free to ask me questions at any time” or “If you have 
questions, I’d be glad to answer them at the conclusion of my talk.” Also, try 
to break the invisible barrier between you and your audience. For example, 
step out from behind the podium or move toward the audience. 
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WRITING 

In the United States, technical writers generally state their claims early and 
clearly. They support their claims by presenting the most important infor- 
mation first and by using numerical data. To become a better writer, try the 
following strategies: 

• State your claims directly. In most cases, state your purpose directly in 
the first paragraph of a memo or letter, as well as at the start of any other 
document and at the start of each section within it. 

• Avoid digressions. Focus on your task. If a piece of information is 
interesting but does not help you make your point, do not include it. 

• Move from one point to the next systematically. Use an appropriate pattern 
of organization, and use transitions and other devices to ensure a smooth 
flow within a paragraph and between paragraphs. 

• Use logic and technical information rather than allusion, metaphor, or 
emotion. Western readers are persuaded more by numerical data — that is, 
by statistics, whether raw scores, dollar amounts, or percentages — than by 
an emotional appeal or an argument from authority. 

• Use an appropriate level of formality. Consider your audience, your subject, 
and your purpose. In the United States, email messages and memos tend 
to be less formal than reports and proposals. In most cases, avoid overly 
formal words, such as pursuant, aforementioned, and heretofore, in favor of 
clear, concise writing. 


For more about organizing 
information, see Ch. 7. For more 
about writing coherent paragraphs, 
see Ch. 9. 


For more about persuasion, see Ch. 8. 


For more about choosing the right 
words and phrases, see Ch. 10, pp. 
230-42. 


Sentence-Level Issues 


sent 


BASIC CHARACTERISTICS OF A SENTENCE 


A sentence has five characteristics. 


1. It starts with an uppercase letter and ends with a period, a question 
mark, or (rarely) an exclamation point attached to the final word. 

I have a friend. 

Do you have a friend? 

I asked, "Do you have a friend?" 

The question mark is part of the quoted question. 

Did you write "Ode to My Friend"? 

The question mark is part of the question, not part of the title in quotation 
marks. 


Yes! You are my best friend! 
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2. It has a subject, usually a noun. The subject performs the action(s) men- 
tioned in the sentence or exists in a certain condition according to the 
rest of the sentence. 

SUBJECT 

My friend speaks five languages fluently. 

The subject performs an action — speaks. 

SUBJECT 

My friend is fluent in five languages. 

The subject exists as (is) a fluent person. 

3. It has a verb, which tells what the subject does or states its existence. 


My friend is fluent in five languages. 

The verb states that the subject exists. 

4. It has a standard word order. 

The most common sequence in English is subject-verb-object: 

SUBJECT VERB OBJECT 


We hired a consulting firm. 

You can add information in various places. 

Yesterday we hired a consulting firm. 

Information was added to the start of the sentence. 

Yesterday we hired a consulting firm: Sanderson & Associates. 

Information was added to the end of the sentence. 

Yesterday we hired the city's most prestigious consulting firm: Sanderson & 
Associates. 

Information was added in the middle of the sentence. 


VERB 


My friend speaks five languages fluently. 
The verb tells what the subject does. 


VERB 



For more about subordinating words 
and phrases, see p. 681 . 


In fact, any element of a sentence can be expanded. 

5. It has an independent clause (a subject and verb that can stand alone — 
that is, a clause that does not begin with a subordinating word or phrase). 
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The following is a sentence: 

SUBJECT VERB 

I i 

The pump failed because of improper maintenance. 

The following is also a sentence: 

SUBJECT VERB 

The pump failed. 

But the following is not a sentence because it lacks a subject with a verb 
and because it begins with a subordinating phrase: 

Because of improper maintenance. 

An independent clause is required to complete this sentence: 

Because of improper maintenance, the pump failed. 


coor 


LINKING IDEAS BY COORDINATION 


One way to connect ideas in a sentence is by coordination. Coordination is 
used when the ideas in the sentence are roughly equal in importance. There 
are three main ways to coordinate ideas: 

1. Use a semicolon (;) to coordinate ideas that are independent clauses. 

The information for bid was published last week; the proposal is due in less than 
a month. 

2. Use a comma and a coordinating conjunction (and, but, or, nor, so, for, or 
yet) to coordinate two independent clauses. 

The information for bid was published last week, but the proposal is due in less 
than a month. 

In this example, but clarifies the relationship between the two clauses: the 
writer hasn’t been given enough time to write the proposal. 

3. Use transitional words and phrases to coordinate two independent clauses. 
You can end the first independent clause with a semicolon or a period. If 
you use a period, begin the transitional word or phrase with a capital letter. 

The Intel 6 Series chipset has already been replaced; as a result, it is hard to find 
an Intel 6 Series in a new computer. 

The Intel 6 Series chipset has already been replaced. /As a result, it is hard to find 
an Intel 6 Series in a new computer. 


For more about transitional words 
and phrases, see Ch. 9, pp. 209- 1 1. 


sub 


LINKING IDEAS BY SUBORDINATION 


Two ideas can also be linked by subordination — that is, by deemphasizing 
one of them. There are two basic methods of subordination: 
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For more about restrictive and 
nonrestrictive modifiers, see Ch. 10, 

p. 228. 
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1. Use a subordinating word or phrase to turn one idea into a subordinate 
clause. 


after 

because 

since 

until 

while 

although 

before 

so that 

when 

who 

as 

even though 

that 

where 

whom 

as if 

if 

unless 

which 

whose 


Start with two independent clauses: 

The bridge was completed last year. The bridge already needs repairs. 

Then choose a subordinating word and combine the clauses: 

Although the bridge was completed last year, it already needs repairs. 

Although subordinates the first clause, leaving it already needs repairs as the 
independent clause. 

Note that a writer could reverse the order of the ideas: 

The bridge already needs repairs even though it was completed last year. 

Another way to subordinate one idea is to turn it into a nonrestrictive 
clause using the subordinating word which: 

The bridge, which was completed last year, already needs repairs. 

This version deemphasizes was completed last year by turning it into a nonre- 
strictive clause and emphasizes already needs repairs by leaving it as the inde- 
pendent clause. 

2. Turn one of the ideas into a phrase modifying the other. 

Completed last year, the bridge already needs repairs. 

Completed last year was turned into a phrase by dropping the subject and verb 
from the independent clause. Here the phrase is used to modify the bridge. 


For more about verb tenses, see Ch. 
10, pp. 222-23. 


vb 


VERB TENSES 


The four tenses used most often in English are simple, progressive, perfect, 
and perfect progressive. 


1. SIMPLE: an action or state that was, is, or will be static or definite 


SIMPLE PAST (VERB + ed [or irregular past]) 

Yesterday we subscribed to a new ecology journal. 

The action of subscribing happened at a specific time. The action of subscribing 
definitively happened regardless of what happens today or tomorrow. 

SIMPLE PRESENT ( VERB or VERB + s) 


We subscribe to three ecology journals every year. 

The action of subscribing never changes; it’s regular, definite. 
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SIMPLE FUTURE (will + VERB or simple present of be + going to + VERB) 

We will subscribe to the new ecology journal next year. 

We are going to subscribe to the new ecology journal next year. 

The action of subscribing next year (a specific time) will not change; it is 
definite. 
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2. PROGRESSIVE: an action in progress (continuing) at a known time 
PAST PROGRESSIVE (simple past of be + VERB + ing ) 

We were updating our directory when the power failure occurred. 

The action of updating was in progress at a known time in the past. 

PRESENT PROGRESSIVE (simple present of be + VERB + ing) 

We are updating our directory now. 

The action of updating is in progress at a known time, this moment. 

FUTURE PROGRESSIVE (simple future of be + VERB + ing) 

We wiil be updating our directory tomorrow when you arrive. 

The action of updating will be in progress at a known time in the future. 

3. PERFECT: an action occurring (sometimes completed) at some indefinite 
time before a definite time 

PAST PERFECT (simple past of have + VERB + ed [or irregular past]) 

We had already written the proposal when we got your call. 

The action of writing began and ended at some indefinite past time before a 
definite past time. 

PRESENT PERFECT (simple present of have + VERB + ed [or irregular 
past]) 

We have written the proposal and are proud to hand it to you. 

The action of writing began at some indefinite past time and is being com- 
mented on in the present, a definite time. 

FUTURE PERFECT (simple future of have + VERB + ed [or irregular past]) 

We wiil have written the proposal by the time you arrive. 

The action of writing will have begun and ended at some indefinite time in the 
future before the definite time in the future when you arrive. 

4. PERFECT PROGRESSIVE: an action in progress (continuing) until a known 
time 
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PAST PERFECT PROGRESSIVE (simple past of have + been + VERB + ing ) 

We had been working on the reorganization when the news of the merger 
became public. 

The action of working continued until a known time in the past. 

PRESENT PERFECT PROGRESSIVE (simple present of have + been + 

VERB + ing ) 

We have been working on the reorganization for over a year. 

The action of working began at some indefinite past time and is continuing in 
the present, when it is being commented on. 

FUTURE PERFECT PROGRESSIVE (simple future of have + been + VERB + ing ) 

We will have been working on the reorganization for over a year by the time you 
become CEO. 

In the future, the action of working will have been continuing before another 
future action. 


ing 


FORMING VERBS WITH -ING 


English uses the -ing form of verbs in three major ways: 

1. As part of a progressive or perfect progressive verb (see numbers 2 and 4 
on page 683 and above in the “Verb Tenses” section) 

We are shipping the materials by UPS. 

We have been waiting for approval since January. 

2. As a present participle, which functions as an adjective either by itself 

the leaking pipe 

or as part of a participial phrase 

The sample containing the anomalies appears on Slide 1 4. 

3. As a gerund, which functions as a noun either by itself 

Writing is the best way to learn to write, 

or as part of a gerund phrase 

The designer tried inserting the graphics by hand. 


inf 


INFINITIVES 


Infinitives consist of the word to plus the base form of the verb (to write, to 
understand ). An infinitive can be used in three main ways: 


1. As a noun 

The editor's goal for the next year is to publish the journal on schedule. 
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2. As an adjective 

The company requested the right to subcontract the project. 

3. As an adverb 

We established the schedule ahead of time to prevent the kind of mistake we 
made last time. 


help 


HELPING VERBS AND MAIN VERBS 


Instead of a one-word verb, many English sentences contain a verb phrase. 


The system meets code. 

This sentence has a one-word verb, meets. 


The new system must meet all applicable codes. 

This sentence has a two-word verb phrase, must meet. 

The old system must have met all applicable codes. 

This sentence has a three-word verb phrase, must haue met. 

In a verb phrase, the verb that carries the main meaning is called the main 
uerb. The other words in the verb phrase are called helping verbs. The follow- 
ing discussion explains four categories of helping verbs. 

1. Modals 

There are nine modal verbs: can, could, may, might, must, shall, should, will, 
and would. After a modal verb, use the base form of the verb (the form of 
the verb used after to in the infinitive). 

BASE FORM 

i 

The system must meet all applicable codes. 

2. Forms of do 

After a helping verb that is a form of do — do, does, or did — use the base 
form of the verb. 

BASE FORM 

Do we need to include the figures for the recovery rate? 

3. Forms of have plus the past participle 

To form one of the perfect tenses (past, present, or future), use a form of 
have as the helping verb plus the past participle of the verb (usually the 
-ed form of the verb or the irregular past). 

past perfect We had written the proposal before learning of the new RFP. 

present perfect We have written the proposal according to the instructions in 
the RFP. 

We will have written the proposal by the end of the week. 


FUTURE PERFECT 
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For more about active and passive 
voice, see Ch. 10, pp. 231-33. 


4. Forms of be 

To describe an action in progress, use a form of be (be, am, is, are, was, 
were, being, been) as the helping verb plus the present participle (the -mg 
form of the verb). 

We are testing the new graphics tablet. 

The company is considering flextime. 

To create the passive voice, use a form of be plus the past participle. 

The piping was installed by the plumbing contractor. 


agr s/v AGREEMENT OF SUBJECT AND VERB 


The subject and the verb in a clause or sentence must agree in number. That 
is, if the noun is singular, the verb must be singular. 

The valve needs replacement. 

Note the s that marks a singular present-tense verb. 

If the noun is plural, the verb must be plural. 

The valves need replacement. 

Note the s that marks a plural noun. 

Here are additional examples of subject-verb agreement. 

The new valve is installed according to the manufacturer's specifications. 

The new valves are installed according to the manufacturer's specifications. 


When you edit your document for subject-verb agreement, keep in mind 
the following guidelines: 

1. When information comes between the subject and the verb, make sure 
the subject and verb agree. 

The result of the tests is included in Appendix C. 

The results of the test are included in Appendix C. 

2. Certain pronouns and quantifiers always require singular verbs. Pro- 
nouns that end in -one or -body — such as everyone, everybody, someone, 
somebody, anyone, anybody, no one, and nobody — are singular. In addition, 
quantifiers such as something, each, and every are singular. 

singular Everybody is invited to the preproposal meeting. 

singular Each of the members is asked to submit billable hours by the end of the 
month. 

3. When the clause or sentence contains a compound subject, the verb 
must be plural. 

compound subject The contractor and the subcontractor want to meet to resolve 

the difficulties. 
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4. When a relative pronoun such as who, that, or which begins a clause, 
make sure the verb agrees in number with the noun that the relative 
pronoun refers to. 

The numbers that are used in the formula do not agree with the ones we were 
given at the site. 

Numbers is plural, so the verb in the that clause (are) is also plural. 

The number that is used in the formula does not agree with the one we were 
given at the site. 

Number is singular, so the verb in the that clause (is) is also singular. 
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cond 


CONDITIONS 


The word if in English can introduce four main types of conditions: 


1. Conditions of fact 

Conditions of fact usually — but not always — call for the same verb 
tense in both clauses. In most cases, use a form of the present 
tense: 


If rats eat as much as they want, they become obese. 

If you see "Unrecoverable Application Error," the program has crashed. 

Here the present perfect is needed, because the crashing is over when you see 
the message. 

2. Future prediction 

For prediction, use the present tense in the if clause. Use a modal (can, 
could, may, might, must, shall, should, will, or would ) plus the base form of 
the verb in the independent clause. 

If we win this contract, we will need to add three more engineers. 

If this weather keeps up, we might postpone the launch. 

3. Present-future speculation 

The present-future speculation usage suggests a condition contrary to 
fact. Use were in the if clause if the verb is be; use the simple past in the if 
clause if it contains another verb. Use could, might, or would plus the base 
form of the verb in the independent clause. 

If I were president of the company, I would be much more aggressive. 

If I took charge of the company, I would be much more aggressive. 

The example sentences imply that you are not president of the company and 
have not taken charge of it. 

The past tense in the example if clauses shows distance from reality, not 
distance in time. 
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4. Past speculation 

Use the past perfect in the if clause. Use could, might, or would plus the 
present perfect in the independent clause. 

If we had won this contract, we would have needed to add three engineers. 

This sentence implies that the condition is contrary to fact: the contract wasn’t 
won, so the engineers were not needed. 


art 


ARTICLES 


Few aspects of English can be as frustrating to the nonnative speaker as the 
correct usage of the articles a, an, and the before nouns. Although there are a 
few rules that you should try to learn, remember that there are many excep- 
tions and special cases. 

Here are some guidelines to help you look at nouns and decide whether 
they may or must take an article — or not. As you will see, to make the deci- 
sion about an article, you must determine 


• whether a noun is proper or common 


• for a common noun, whether it is countable or uncountable 


• for a countable common noun, whether it is specific or nonspecific, and if 
it is nonspecific, whether it is singular or plural 

• for an uncountable common noun, whether it is specific or nonspecific 


Specific in this context means that the writer and the reader can both identify 
the noun — “which one” it is. 


1. Proper nouns 

Singular proper nouns usually take no article but occasionally take a 
or an: 

James Smith, but not John Smith, contributed to the fund last year. A Smith will 
contribute to the fund this year. 

The speaker does not know which Smith will make the contribution, so an 
article is necessary. Assuming that there is only one person with the name 
Quitkin, the sentence “Quitkin will contribute to the fund this year” is clear, so 
the proper noun takes no article. 

Plural proper nouns often, but not always, take the: 

The Smiths have contributed for the past 1 0 years. 

There are Smiths on the class roster again this year. 

2. Countable common nouns 

Singular and plural specific countable common nouns take the: 

The microscope is brand new. 

The microscopes are brand new. 
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Singular nonspecific countable common nouns take a or an: 

A microscope will be available soon. 

An electron is missing. 

Plural nonspecific countable common nouns take no article but must 
have a plural ending: 

Microscopes must be available for all students. 

3. Uncountable common nouns 

Specific uncountable common nouns take the: 

The research started by Dr. Quitkin will continue. 

The subject under discussion is specific research. 

Nonspecific uncountable common nouns generally take no article: 
Research is always critical. 

The subject under discussion is nonspecific — that is, research in general. 
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adj 


ADJECTIVES 


Adjectives are modifiers. They modify — that is, describe — nouns and pro- 
nouns. Keep in mind four main points about adjectives in English: 


1. Adjectives do not take a plural form. 

a complex project 
three complex projects 

2. Adjectives can be placed either before the nouns they modify or after 
linking verbs. 

The critical need is to reduce the drag coefficient. 

The need to reduce the drag coefficient is critical. 

3. Adjectives of one or two syllables usually take special endings to create 
the comparative and superlative forms. 

Positive Comparative Superlative 

big bigger biggest 

heavy heavier heaviest 

4. Adjectives of three or more syllables take the word more for the com- 
parative form and the words the most for the superlative form. 

Positive Comparative Superlative 

qualified more qualified the most qualified 

feasible more feasible the most feasible 
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For more about expletives, see Ch. 

10, p.226. 


adv 


ADVERBS 


Like adjectives, adverbs are modifiers. They modify — that is, describe — verbs, 
adjectives, and other adverbs. Their placement in a sentence is somewhat 
more complex than the placement of adjectives. Remember five points about 
adverbs: 


1. Adverbs can modify verbs. 

Management terminated the project reluctantly. 

2. Adverbs can modify adjectives. 

The executive summary was conspicuously absent. 

3. Adverbs can modify other adverbs. 

The project is going very well. 

4. Adverbs that describe how an action takes place can appear in differ- 
ent locations in a sentence — at the beginning of a clause, at the end of 
a clause, right before a one-word verb, or between a helping verb and a 
main verb. 

Carefully the inspector examined the welds. 

The inspector examined the welds carefully. 

The inspector carefully examined the welds. 

The inspector was carefully examining the welds. 

NOTE: The adverb should not be placed between the verb and the direct 
object. 

incorrect The inspector examined carefully the welds. 

5. Adverbs that describe the whole sentence can also appear in different 
locations in the sentence — at the beginning of the sentence, before an 
adjective, or at the end of the sentence. 

Apparently, the inspection was successful. 

The inspection was apparently successful. 

The inspection was successful, apparently. 


omit 


OMITTED WORDS 


Except for imperative sentences, in which the subject you is understood (Get 
the correct figures), all sentences in English require a subject. 


The company has a policy on conflict of interest. 


Do not omit the expletive there or it. 

incorrect Are four reasons for us to pursue this issue. 

There are four reasons for us to pursue this issue. 


CORRECT 
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incorrect Is important that we seek his advice. 
correct It is important that we seek his advice. 


rep 


REPEATED WORDS 


1. Do not repeat the subject of a sentence. 

incorrect The company we are buying from it does not permit us to change our 
order. 

correct The company we are buying from does not permit us to change our 
order. 

2. In an adjective clause, do not repeat an object. 

incorrect The technical communicator does not use the same software that we 
were writing in it. 

correct The technical communicator does not use the same software that we 
were writing in. 

3. In an adjective clause, do not use a second adverb. 

incorrect The lab where we did the testing there is an excellent facility. 

correct The lab where we did the testing is an excellent facility. 


S For more practice with the concepts covered in Part D, 
complete the LearningCurve activities under "Additional 
Resources" in Appendix, Part D: macmillanhighered.com 
/launchpad/techcomml 1 e. 
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comma splices and, 218, 661 
independent clauses and, 681 
run-on sentences and, 218-19 
coordination, linking ideas with, 
681 

copy lines 

in emails, 375, 375/ 
in letters, 365, 365/ 
copyright law, 24-27, 287 
editing and, 343 
ethical communication and, 37 


fair use and, 24, 25 
graphics and, 301-03, 586 
copyright page, in manuals, 570 
correctness 

in correspondence, 360-61 
as measure of excellence, 8 
correlative constructions, 229 
correspondence, 358-81 
cliches in, 362, 362 /, 363/ 
correctness in, 360-61 
cultural considerations and, 
380-81 

emails as, 374-77, 378 
formality level for, 360-61 
honesty in, 362 
letters as, 363-71 
memos as, 372-74 
microblogs as, 377-80 
presenting yourself effectively 
in, 360-63 

selecting type of, 360 
writer’s checklist for, 382 
“you” attitude in, 361-62, 378 
countable common nouns, 688-89 
cover, of recommendation report, 
478t, 479 

Creative Commons, 25, 25/ 
credentials, in proposals, 427, 437, 
442 

criteria 

in comparison-and-contrast 
organizational pattern, 156 
in recommendation reports, 471, 
47 It, 472, 498 

critiquing work of others, 67, 68, 

69, 78 

cropping photographs, 330, 331/ 
cross-references, in progress 
reports, 453 

cross-reference tables, 259t 
cultural considerations, 88. See also 
multicultural audiences 
in business correspondence, 
102-03, 380-81 
in collaboration, 77 
in document design, 104, 254-55, 
286-87 

in informational reports, 447-48 
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cultural considerations (cont.) 

in international job applications, 
393 

in international proposals, 

425-26 

in manuals, 570-71 
in memos, 372, 372/ 
for nonnative speakers of 
English, 677-79 
in oral presentations, 600 
in persuasive writing, 182 
in recommendation reports, 

475 

beneath surface, 97-99 
on surface, 95-97 
in usability evaluation, 348 
in website design, 286-87 
writer’s checklist for, 112 
currentness, of information found 
through research, 128 
cutaway drawings, 333/ 

dangling modifiers, 230 
dashes 

quotation marks and, 668 
uses of, 664-65 
data 

analysis and reporting of, 143, 

521 

from experiments, 134-35 
from field research, 136 
point, 298 

presenting in appendixes, 

141-43, 443 

presenting in lab reports, 520-21, 
529 

presenting in tables, 310-11 
from usability tests, 352 
databases, 120, 653 

APA reference list style for 
dissertations on, 627 
IEEE reference list style for 
articles on, 639 
MLA works cited style for 
articles on, 652, 653 
data set, APA reference list style 
for, 627 


dates. See also dates of publication; 
retrieval dates 
commas in, 661 

cultural variety in expressing, 96 
dates of publication 

APA reference list style for, 621, 
622, 624, 626, 628 
IEEE reference list style for, 635, 
636, 638, 639 

MLA works cited style for, 645, 
646, 649, 651, 653 

debriefing, in usability testing, 352 
decimal fractions, 671, 672 
decision matrix, 473-74, 473/ 
definitions, 535-43 
circular, 537 
extended, 537-41 
in lab reports, 519 
parenthetical, 536 
placement of, 541-43 
sentence, 536-37, 542, 542/ 
types of, 536 
uses of, 535 

writer’s checklist for, 571-72 
deliverables, 422-24 

collaboration and, 62-63 
honesty about in progress 
reports, 452 
planning for, 117 
DemographicsPro, 83 
demonstrations, as primary 
research, 133-34 

demonstrative pronouns, 211, 220 
density, of screens, 274t 
dependent clauses 
commas with, 660 
linking to independent clauses, 
217-18 

pronoun references and, 219 
deployment flowcharts, 327, 328 
descenders, and underlining, 272 
descriptions, 534, 543-51 
concluding, 547-48, 551/ 
detail in, 546-47 
examples of, 548, 549/ 553/ 
graphics in, 534, 545t, 546 if, 547, 
549/ 551/ 


introducing, 545 
of mechanisms, 543, 545, 545t, 
547—48, 550/ 

nature and scope of, 544-45 
of objects, 543, 545, 545t, 547-48 
part-by-part, 546 
of processes, 543, 545, 545t, 547, 
548, 549/, 553/ 
specifications and, 552/ 
step-by-step, 546-47 
writer’s checklist for, 571-72 
descriptive abstracts, 480, 480/ 518 
design, 250-93. See also page design; 
website design 
of accessing aids, 256, 258t, 

259t 

audience and, 250, 254-55, 281 
ethical and legal considerations 
in, 38, 38/ 287 

features of, 272, 273t-74t, 275 
goals of, 250 
of instructions, 555-57 
for multicultural audiences, 104, 

254- 55 

of overall print document, 47, 

255- 59 

planning in, 254-55 
principles of, 250-54 
readability and, 7 
writer’s checklist for, 291 
desirable criteria, 471-72 
detail, 233 

cultural variation in level of, 98 
in descriptions, 546-47 
deviation bar graphs, 317/ 
diagrams, 308t, 323, 324/ 
in lab reports, 521 
dictionaries, online, APA reference 
list style for, 627 
digital object identifier. See DOI 
direct costs, for proposals, 432 
directives, 446, 447-48, 448/ 
writer’s checklist for, 466 
writing, 447-48 
directness, in U.S. culture, 677 
directory search engines, 122 
direct quotations, 667-78 
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disabilities, people with 

people-first approach to, 241^2 
website design for, 285-86 
discriminatory language, 39, 24CMH 
discussion boards, 118t, 119t, 124, 
125/ 

APA reference list style for 
postings to, 629-30 
discussion section, in lab reports, 
522, 530 
dissertations 

APA reference list style for, 627 
IEEE reference list style for, 637 
MLA works cited style for, 652 
dividers, as accessing aids, 258t 
do, forms of, 685 
documentation of sources, 26, 
486-87. See also APA style; 

IEEE style; MLA style 
functions of, 614 
for graphics, 298, 301-03, 310/, 
312 

plagiarism and, 26 
for tables, 310, 310/ 
document-delivery services, 122 
document design. See design; page 
design; website design 
DOI, APA reference list style for, 

625, 628 

Donaldson, Thomas, 36 
dot leaders, in tables, 311 
double-blind field research, 135-36 
drafting, in writing process, 42, 
48-51 

of correspondence, 359 
guidelines for, 48^19 
of informational reports, 447 
of proposals, 421 
of recommendation reports, 470 
styles and, 51 
templates and, 48-50 
drafts 

archiving, 344 
critiquing, 68-69, 70, 78 
drawings. See also graphics 
cutaway, 333/ 
exploded, 333/ 


in instructions, 564/ 
phantom, 333/ 
showing motion in, 327, 329/ 
uses of, 309t, 332 
drawing tools, 275, 320 
Driskill, L., 97 
Dumas, Joseph S., 351 
DVDs, MLA works cited style for, 

656 

easy-to-read text 

on presentation graphics, 583-84 
on web pages, 288 
easy-to-see graphics, for oral 
presentations, 583 
economic variables, 96 
edited books 

APA reference list style for, 623 
IEEE reference list style for, 

635 

MLA works cited style for, 647, 
648 

editing, 42, 54, 658-75 
abbreviations for, 658 
of correspondence, 359 
guidelines for, 343-45 
of informational reports, 447 
of instructions, 563 
mechanics of, 669-75 
punctuation and, 659-69 
of recommendation reports, 

470 

reviewing and, 341, 343-45 
writer’s checklist for, 355 
edition number 

APA reference list style for, 

623 

IEEE reference list style for, 635 
MLA works cited style for, 648 
education 

as cultural variable, 96 
in job-application letters, 412, 
412/ 

of readers, 87 
in resumes, 399-400 
either-or arguments, 183t 
electronic portfolios, 392 


electronic resumes, 406-08, 407/ 
408/ 

format of, 406 
preparing, 406 
electronic sources 

APA reference list style for, 620, 
625-30 

APA textual citation style for, 
619 

IEEE reference list style for, 634, 
637 

MLA textual citation style for, 
644 

MLA works cited style for, 645, 
650-54 

electronic tools, in collaboration, 
69-76 

elevator pitch, 390 
ellipses 

in quotations, 610 
uses of, 668-69 
email, 360, 374-77 

APA reference list style for, 

630 

collaboration through, 15 if 
cultural considerations in, 
380-81 

elements of, 375, 375/ 
follow-up, after job interview, 
414-15 

MLA works cited style for, 654 
netiquette in, 375-76, 376/-77/, 
378/ 

primary research using, 138 
reports in form of, 446 
viruses and, 539 
writer’s checklist for, 382 
writing, 374-77 
emotions 

appealing to, 179, 180/ 
effective listening and, 62 
emphasis 

color for, 304 
editing and, 344 
of new information in 
sentences, 223-24 
uppercase letters for, 406 
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employers 

ethical obligations to, 21-22 
learning about, 387 
employment. See job search 
employment history, 401-02 

in job-application letters, 411-12, 
412/ 

on resumes, 400-02, 407/ 
enclosure line, on letters, 365, 365 if, 
368, 368/, 412, 412/ 
encyclopedias, online, APA 

reference list style for, 627 
engineering 

articles in, 523, 526, 526/, 527 
lab notebooks in, 517 
environment, ethical obligations 
to, 23 

environmental impact statements, 
163 

epitome, 483 

Equal Economic Opportunity (EEO) 
Tabulation, 187 
equations, 519 
equipment 

constraints of on design, 255 
for oral presentations, 586 
equipment and methods section, in 
lab reports, 520 
equipment catalogs, 159 
ethical constraints, 174 
ethics, 18-39. See also ethics notes 
codes of conduct and, 31, 74 
conflicts in, 19-20 
corporate culture and, 30-32 
moral standards in, 18-19 
multicultural audiences and, 
36-37 

obligations deriving from, 21-23 
persuasive writing and, 174 
principles for communication 
deriving from, 37-39 
social media and, 32-34 
writer’s checklist for, 39 
ethics notes 

on acknowledging reviewers, 54 
on answering questions, 601 
on burying bad news in 
paragraphs, 205 


on business correspondence, 362 
on collaborative projects, 67 
on comparing and contrasting, 
158 

on data analysis and reporting, 
143, 521 

on euphemisms, 236 
on graphics, 298 

on informed consent in usability 
testing, 352 

on meeting needs of readers, 104 
on online document design, 287 
on persuasive writing, 184 
on plagiarism and reuse of 
information, 26 
on presenting 

recommendations, 475 
on professional online presence, 
76 

on reporting progress, 452 
on resumes, 391 
on safety information, 558 
on type sizes, 268 
on writing proposals, 427 
ethics office, 30, 37 
ethics officer, 31, 196 
ethics programs, 31 
etymology, 541 
euphemisms, 38, 236 
evaluation. See also evaluation 
materials; usability 
evaluations 

description of in proposals, 435 
relationship of to reviewing and 
testing, 341-42, 342/ 
evaluation materials 
creating, 63 

for oral presentations, 601, 
602/-03/ 

for self-evaluation, 66/ 
for team-member evaluation, 65/ 
event analysis, 152, 153 
evidence 

arguments and, 175-77, 178/, 181 
claim placement and, 179 
examples as, 176-77, 178/ 
expert testimony as, 177 
kinds of, 176-77 


in lab reports, 516, 520 
numerical data as, 176-77 
photographs as, 185, 185/ 
examples 

as evidence, 176-77, 178/ 
as extended definitions, 538 
exclamation points, 664, 668 
executive overview, 483-84 
executive summary, in 

recommendation reports, 
476t, 483-84, 493 
expectations of readers, 47 
about documents, 90 
editing and, 343 
about instructions, 556 
experiments, 134-35 
expert testimony, 175-77, 178/ 
expletives, 226 
exploded drawings, 333/ 
express warranty, 27-28, 37 
extemporaneous presentations, 
577, 597 

extended definitions, 537-42, 542/ 
analogy in, 540 

comparison and contrast in, 540 
etymology in, 541 
examples in, 538 
graphics in, 538-39 
negation in, 540-41 
partitioning in, 538-39 
principles of operations in, 539 
external proposals, 421-22 
readers’ needs in, 425-26 
uses of, 421-22 
eye contact 

in oral presentations, 599-600 
U.S. communication style and, 
678 

in videoconferencing, 73 

Facebook, 285, 388-89 
fair-mindedness, 184 
fair use, 24, 25 
Falls, Jason, 83 
fancy words, 239, 239t 
FAQ pages, 285 

feasibility reports, 469-70. See also 
recommendation reports 
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feasibility studies 

classification organizational 
pattern for, 159 
more-important-to-less- 
important organizational 
pattern for, 154 
in recommendation reports, 
469-70 

spatial organizational pattern 
for, 153 

FedBizOpps website, 422, 423/ 
feedback statements, 562 
field reports, 446, 450-51, 450/-51/ 
writer’s checklist for, 466 
writing, 450-51 
field research, 135-36 
bias in, 135-36 
double-blind, 135 
figures, 306. See also graphics 
lists of, 483 
fillers, 237 

fill patterns, for pie charts, 323 
films 

APA reference list style for, 631 
MLA works cited style for, 656 
filtering, and page design, 261, 261/ 
final reports, 424, 469. See also 
recommendation reports 
financial constraints, in persuasive 
writing, 174 

findings, in recommendation 

reports, 477, 483, 484, 488, 491, 
493 

flaming, in email and microblogs, 
376, 377 

flowcharts, 152, 309t, 327, 328/, 473, 
545 

focus groups, 347^18 
follow-up letters, after job 
interviews, 414-15 
fonts, 267 
footers, 279/ 

as accessing aids, 259t 
formatting, 582 
for websites, 261, 282/, 283 
footnotes 

placing definitions in, 543 
for tables, 312 


formality, levels of, 230-31 
in correspondence, 360-61 
in email, 376 

U.S. communication style and, 
679 

format 

of abstracts, 591 
of headers, 482 
of informational reports, 446/ 
of lab reports, 517-23 
of letters, 363-66, 366/ 
in persuasive writing, 175 
of plain-text resumes, 406 
of proposals, 428 
of recommendation reports, 582 
of skills resumes, 409, 409/ 
formative evaluation, 435 
formatted resume, 409 
forms 

for evaluation of oral 

presentations, 601, 602/-03/ 
for incident reports, 462/ 
for meeting minutes, 464, 465/ 
for self-evaluation, 66/ 
for usability testing, 350 
forwarding email, 376 
fractions, 671, 672 
freewriting, 44t 
front matter 

for manuals, 570 
for recommendation reports, 
479-84, 479t 
Fuente Academica, 123 
full block format of letters, 366/ 
full justification, 269, 279/ 
future 

looking to in oral presentations, 
582 

prediction of and verb tense, 687 
future tense 

perfect, 683, 685 
perfect progressive, 684 
progressive, 683 
simple, 683 

Gantt charts, 433, 433/, 434, 441, 459 
gender, and collaboration, 77 
gender-neutral language, 240^11 


general descriptions, 543 
general introductions, in 
instructions, 561-63 
general- to-specific organizational 
pattern, 150t, 151/ 154, 155/ 
guidelines for, 154 
writer’s checklist for, 167 
gerunds, 564, 666, 684 
gestures 

cultural considerations and, 600 
in oral presentations, 600 
U.S. communication style and, 
678 
glossaries 

for easy-to-translate text, 243 
in manuals, 570 
placing definitions in, 535, 543 
in recommendation reports, 
476t, 484, 486, 487/ 

“good news” adjustment letter, 370, 
370/ 

goods and services proposals, 424 
government documents, 123 
APA reference list style for, 630 
IEEE reference list style for, 640 
MLA works cited style for, 

654-55 

government websites, 124 

IEEE reference list style for, 637 
grade-point averages, listing on 
resumes, 399 

grammar-checkers, 55, 233 
grammatical form, of headings, 198 
grammatical sentences, 216-23 
grant proposals, 445 
graphics, 294-335. See also figures; 
graphs; tables 
animation in, 585-86, 588 
APA reference list style for, 627 
audience needs and, 104, 105 /, 
106/ 297, 299 
captions for, 426 
cause-and-effect organizational 
pattern and, 165 
characteristics of effective, 297 
choosing kind of, 306-33 
chronological organizational 
pattern and, 152 
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graphics (cont.) 

classification or partition 
organizational pattern and, 
160 

comparison-and-contrast 
organizational pattern and, 
159/ 

creating, 301-06 

cultural considerations and, 101, 
295-96, 334-35, 535, 600 
in descriptions, 534, 545, 545t, 
546 /, 547, 551/ 

documentation of, 298, 301-03, 
586, 614, 656 
ease of reading, 583-84 
editing and, 344 
in Excel, 314 

in extended definitions, 538 
functions of, 295-96 
general-to-specific 

organizational pattern and, 
154 

honesty of, 298, 521 
inserting in documents, 302 
labeling, 297, 314, 315 /, 322, 330 
in lab reports, 520-21, 529 
liability law and, 28, 29 
in manuals, 570-71 
master page design and, 587 
more-important-to-less- 
important organizational 
pattern and, 156 
multicultural audiences and, 
334-35, 535 

for oral presentations, 578/, 
582-88, 583 / 584/ 585, 586, 
587/ 588/ 589/-92/ 
in persuasive writing, 185, 187/ 
problem-methods-solution 
organizational pattern and, 
163 

in proposals, 426 
showing logical relationships 
in, 296 

showing motion in, 327, 328/ 
329/ 

showing numerical information 
in, 296, 306-23 


showing process descriptions 
and instructions in, 296, 308t, 
309t, 326-29, 534, 553/ 557, 
563 

showing visual and spatial 

characteristics in, 309t, 330-34 
spatial organizational pattern 
and, 153 

with specifications, 552, 552/ 
in technical communication, 7, 
15/ 

writer’s checklist for, 335 
graphs. See also bar graphs 
in lab reports, 521 
line, 308t, 319, 321, 321/ 
grid lines 

in bar graphs, 312, 313/ 315 
in line graphs, 321 
grouped bar graphs, 316t 
groups 

cultural focus on, 97 
leaders of, 63 
setting tasks for, 63 

Habitat for Humanity, 388 
handbooks, 118t 
hand gestures. See gestures 
handicapped, use of, 242 
handouts, for oral presentations, 
593 

hanging indentation, 203 
hashtags, 126, 380 
hasty generalization, 177, 183t 
have, forms of, 685 
hazardous-product laws, 36 
headers 

as accessing aids, 259t 
formatting, 582 
for websites, 282, 282/ 
headings, 194-98 

back-to-back, 196-98 
capitalization of, 675 
cultural considerations and, 148 
grammatical form of, 198 
in lab reports, 528 
in letters, 364, 364/ 365/ 
levels of, 194-95 
line spacing and, 270/ 272 


long noun strings in, 197 
in memos, 374 
organizational pattern and, 

149 

page design and, 272, 276/ 
primary, 194 

in recommendation reports, 
480-81, 492, 494 
revision guidelines for, 197-98 
secondary, 194 
skimming, 606 
styles and, 195-96 
in tables of contents, 480-81 
writer’s checklist for, 223 
hearing impairment, and website 
design, 286 
helping verbs, 685-86 
help section, in manuals, 570 
Helvetica family of type, 266, 266/ 
heuristic, 347 
heuristic evaluation, 347 
hierarchy of information, 194 
highlighting features, in word 
processors, 70 
Hoft, Nancy L., 96 

home page. See also website design 
design of, 290/ 
links on, 281, 284 
honesty 

in answering questions, 601 
in correspondence, 362 
editing and, 343 
as ethical obligation to 
employer, 21-22 
in graphics, 286 
in job-application materials, 

388 

in lab reports, 521 
as measure of excellence, 7-8 
in persuasive writing, 184 
in progress reports, 452 
in proposals, 427 
honors, listing on resumes, 399, 
407/ 408/ 409/ 

HootSuite, 132-33 

horizontal axis, on graphs, 297, 298, 
315, 321 

horizontal rules, 273t 
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Horton, William, 306, 334-35 
how-to manuals. See manuals 
how-to titles, in instructions, 561 
humor, 243 
hyperlinks. See links 
hyphens 

linking compound adjective 
with, 670 

in noun strings, 235 
uses of, 670-71 

icons 

as accessing aids, 258t, 286 
for warning labels, 28, 28 /, 29, 38, 
38/, 559 f, 560 / 

idea generation, 44, 44t-45t 
identifying information, in 

chronological resumes, 398 
idioms, 101, 287 
IEEE style, 526, 526 / 614-15 

for reference list entries, 634^10 
for textual citations, 633-34 
IFB (information for bid), 422, 428 
ignorance, argument from, 182t 
illustrations, lists of, 476t, 481, 483, 
483/ 

IM, 71, 73, 193 
imperative mood 

dangling modifiers and, 230 
in instructions, 562 
implied warranty, 28, 37 
impromptu presentations, 577 
inadequate sampling, 183t 
incidental information, setting off, 
665 

incident reports, 446, 462-64, 462/, 
463/ 

writer’s checklist for, 466 
writing, 462-64 
indentation 

APA reference list style for, 620 
hanging, 203, 620 
MLA works cited style for, 645 
independence, in U.S. culture, 677 
independent clauses, 680-81 
linking dependent clauses to, 
217-18 

semicolons and, 218, 662 


indexes 

in manuals, 570 
newspaper, 122-23 
periodical, 122 
skimming, 606 
indicative abstracts, 480 
indicative mood, 230, 562 
indirect costs, for proposals, 432 
indirect quotations, 667 
individuals, cultural focus on, 97 
industry standards, in manuals, 

570 

infinitives, 684-85 
infographics, 159, 166/ 317-19 
critique of, 320/ 

informal language, 230-31, 360-61, 
376 

information. See a Iso organizational 
patterns 

evaluating, 127-30 
graphics as, 297, 306, 307/, 
308t-09t 

in headings, 194-95, 198 
new, emphasizing, 223-24 
informational constraints, in 
persuasive writing, 174 
informational reports, 446-65. See 
a Iso reports 
activity reports as, 451 
directives as, 447 
field reports as, 450-51 
honesty in, 452 
incident reports as, 462-64 
meeting minutes as, 464 
progress reports as, 451-61 
status reports as, 451-53 
writer’s checklist for, 466 
writing, 446-47 
information centers, 120 
information for bid (IFB), 422, 428 
informative abstracts, 480, 518 
informed consent, in usability 
testing, 352 
-ing verbs, 564, 684 
inoffensive language, 241^12 
inquiries, as primary research, 

138 

inquiry letters, 138, 366, 367, 367/ 


inside address, 363-64, 364/, 412, 
412/ 

inspections, as primary research, 
134 

instant messaging (IM), 71, 73, 

193 

Institute of Electrical and 

Electronics Engineers. See 
IEEE style 

instructional videos, 554-55 
instructions, 534, 551-69 
articles (a, an, the) in, 563 
audience for, 555-56 
conclusions to, 563 
cultural attitudes toward, 

334 

designing, 555-57 
drafting, 560-63 
environment for, 556-67 
general introduction to, 561 
general-to-specific 

organizational pattern for, 

154 

graphics for, 309t, 326-29, 557, 563 

liability law and, 28, 29 

list of tools and materials in, 

561, 565/ 
manuals vs., 569 
multilingual, 556 
organization of, 560 
page design for, 557, 557/ 
process descriptions vs., 560 
revising, editing, and 
proofreading, 563 
safety information in, 558-60, 
558/ 560/ 
samples of, 563-66 
showing motion in, 327, 329/ 
step-by-step, 561-63 
titles in, 561 
uses of, 555 

writer’s checklist for, 572 
writing, 555 

intercultural communication. 

See cultural considerations; 
multicultural audiences 
interests, listing on resumes, 

402-03 
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interjections, commas with, 

660 

interlibrary loans, 122 
internal proposal, 421 
readers’ needs in, 425 
sample of, 435-42 
uses of, 421 

International Organization for 
Standardization (ISO), 559, 
559 / 

international proposals, 425-26 
interpersonal conflict, 60, 67 
interpreters, 600 
interpreting data from usability 
tests, 353 

interviews. See also job interviews 
APA reference list style for, 

631 

for audience analysis, 91-92 
choosing respondents for, 136 
conducting, 137 
MLA works cited style for, 

655 

preparing for, 136-37 
presenting data from, 138 
for primary research, 118t, 119t, 
136-38 

transcripts or excerpts of, 138, 
139/ 

in usability evaluation, 346^7 
introductions 

cultural variables and, 148 
in instructions, 561 
in job-application letters, 412, 
412/ 

in lab reports, 518-19, 528 
in lists, 199-200 
in oral presentations, 581 
in progress reports, 455 
in proposals, 429, 437-38 
in recommendation reports, 
476-77, 476t, 494 
skimming, 606 
introductory series, 665 
introductory words, commas with, 
659 

invisible writing, 49 


issue number 

APA reference list style for, 624, 
628 

IEEE reference list style for, 638, 
639 

MLA works cited style for, 649, 
653 

italics, 266, 267, 267/ 570, 669-70 
jargon, 101, 234 

job-application letters, 392, 411, 

412, 412/ 

persuasive writing in, 186/ 
selectivity and development in, 
412, 412/ 

writer’s checklist for, 416 
writing, 411, 412/ 
job boards, 392-94 
job fairs, 391 
job interviews 

follow-up after, 414-15 
preparing for, 391-92, 411, 413-14 
writer’s checklist for, 416 
job offers 

accepting, 414-15 
rejecting, 415 

job search, 386-96. See also job- 
application letters; job 
interviews; resumes 
honesty in, 388 

for international positions, 393 
portfolio for, 392 
preparing for, 387, 391-93 
social media and, 388-89, 

392-93, 394-96 
journal articles 

APA reference list style for, 623, 
624 

classification organizational 
pattern for, 159 

IEEE reference list style for, 637 
MLA works cited style for, 649, 
650 

in science and engineering, 523, 
526, 526/ 527 

use of for research, 118t, 119t 
journal indexes, 122 


journalistic questions, 44t 
justice, standard of, 19 
justification 
full, 269-71 
left, 269-71, 279, 406 
modifying, 271 
page design and, 281-82 

key terms 

defining for multicultural 
audiences, 535 
in proposals, 429 
in recommendation reports, 477, 
495 

repeating, 211 
keywords 

in lab report titles, 518, 527 
in recommendation reports, 479, 
491 

in resumes, 397 

tagged, on websites, 126, 127/ 

labels 

for appendixes, 487 
capitalization of, 675 
for graphics, 297, 312, 312/ 322, 
330 

for linked descriptions, 546/ 
for photographs, 330 
for safety information, 558, 559/ 
560, 560/ 

lab reports, 446, 516-31 
abstract in, 517, 518, 527 
acknowledgments in, 522-23, 
523/ 

appendixes in, 523 
conclusion in, 522 
discussion section in, 522, 530 
equations in, 519 
evaluating, 527 
introduction to, 518-19, 528 
materials and methods section 
in, 520, 528 

persuasion and, 516-17 
presenting data honestly in, 521 
references in, 523, 530 
results section in, 520-21, 529 
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sample, 527-30 
structure of, 517-23 
title in, 518, 527, 529 
writer’s checklist for, 531 
writing, 517 
language 

clarity of, 231-40 
conciseness of, 236-39 
for correspondence, 381-82 
cultural considerations in, 
286-87, 334-35, 381 
formality of, 230-31 
inoffensive, 24-42 
for instructions, 556 
for manuals, 566 if, 570 
nondiscriminatory, 39, 240-42 
for oral presentations, 593-96 
for questionnaires, 140 
and tone, 381 
writer’s checklist for, 244 
language ability, listing on resumes, 
404 

lawsuits, liability, 28, 28 / 
leading, in page design, 268 
lead-ins, for lists, 199-200 
learning theory, and page design, 
260, 260 if, 261, 261/ 
lectures 

APA reference list style for, 631 
MLA works cited style for, 655 
left justification, 270, 271, 406 
legal cases, MLA works cited style 
for, 656 

legal constraints, in persuasive 
writing, 174 

legal obligations, 18, 24-29 
under contract law, 27-28 
under copyright law, 24-26 
corporate culture and, 30-32 
editing and, 343 
under liability law, 28, 28/ 
under trademark law, 26-27, 34 
writer’s checklist for, 39 
legibility, of graphics for oral 
presentations, 583-84 
legislative act, MLA works cited 
style for, 656 


length 

of oral presentations, 586 
of paragraphs, 207-09, 287 
of sentences, 224-25, 287 
letters, 360, 362-71. See also job- 
application letters 
adjustment, 370, 370/, 371, 371/ 
claim, 366, 369, 369/ 
cultural considerations in, 381 
elements of, 363, 364/ 
format of, 366, 366/ 
inquiry, 366, 367, 367/ 

MLA works cited style for, 655 
in response to inquiry, 366, 368, 
368t 

supporting, 432-33 
of transmittal, with 

recommendation reports, 
476t, 479, 488 
writer’s checklist for, 382 
writing, 362-71 
Levitt, Stephen D., 390 
liability law 

ethical communication and, 
36-37 

guidelines for abiding by, 29 
multicultural considerations in, 
36 

obligations under, 28, 29/ 
libraries, 120-23 
licensing symbols, 25/ 

Likert-scale questions, 140t, 142/ 
line breaks, hyphenating, 671 
line drawings, 309t, 332, 332/ 
line graphs, 319, 321, 321/ 
in Excel, 314 
grid lines for, 321 
horizontal and vertical axes on, 
297, 321 

plotting multiple lines on, 321/ 
proportions in, 321 
uses of, 300, 308t, 319 
line lengths, and page design, 

268 

line spacing 

for headings, 271 
modifying, 271 


page design and, 268-69, 269/, 
270/ 

linguistic variables, 96 
Linkedln, 92-93, 93 if, 388-89, 391, 
392/, 394-96, 397 
employment feature of, 396 
links 

placing definitions in, 541, 546/ 
text versions of, 284 
website design and, 284t, 285, 
288-89 
listening 

in meetings, 62 
U.S. style of, 678 
lists, 198-204 

advantages of, 198-200 
breaking up, 201 
bulleted, 199, 200, 203, 585-86 
creating, 203 
of figures, 481 

of illustrations, 476t, 481, 483, 
483/ 

in instructions, 564/ 
lead-ins for, 199-200 
multicultural audiences and, 204 
numbered, 156, 203 
paragraphs vs., 198, 199, 199 /, 

200 

parallel structure of, 201 
punctuation of, 202-03 
of symbols, 470t, 484, 486, 487, 
487/ 

of tables, 481-83 

of tools and materials, 563, 565/ 

uses of, 198 

writer’s checklist for, 213 
living documents, 42 
logical fallacies 

in cause-and-effect 

organizational pattern, 165 
in persuasive writing, 182 
writer’s checklist for, 189 
logical relationships, on graphics, 
296, 308t, 323 
logic boxes, 472 /, 473 
logic trees, 309t, 327 , 329/ 
long sentences, 224-25 
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loose-leaf binders, 257t 
lowercase letters, 267, 267/ 

magazine articles 

APA reference list style for, 625 
IEEE reference list style for, 637 
MLA works cited style for, 650, 
652 

use of for research, 118t, 119t 
main ideas, 62 
main points 

in meeting minutes, 465, 465/ 
in oral presentations, 581 
maintenance tips, 563, 570 
management, project, 60-61 
management approval, 109 
management overview, 483 
management summary, 483 
mandatory language, 566/ 
mannerisms, 600 
manuals, 569-71 
back matter in, 570 
front matter in, 570 
instructions vs., 569 
organization of, 569 
planning, 569-71 
safety information in, 566, 

566/ 

specifications in, 570 
writing, 569-71 
maps 

from clip art, 334, 334/ 
color on, 334/ 

MLA works cited style for, 656 
uses of, 309t 
marginal glosses 

page design and, 264, 272, 274t, 
277/ 541 

placing definitions in, 541 
margins 

page design and, 264/ 
purposes of, 264 
setting up, 257 
typical widths of, 264, 264/ 
master page design, 587 
materials, list of, 563, 565/ 
materials and methods section, in 
lab reports, 520, 528 


matrix, decision, 473-74, 473/ 
measurement units, in tables, 
310-11 

mechanics, 669-76 
mechanism descriptions, 543 
detail in, 546-47 
example of, 548, 550/-51/ 
introducing, 545, 545t 
medium 

IEEE reference list style for, 639 
MLA works cited style for, 645, 
646, 649, 651, 653 

meeting minutes, 446, 464-65, 465/ 
informal, 67 

templates for, 464, 465, 465 if 
writer’s checklist for, 466 
writing, 464 

meetings. See also meeting minutes 
agendas for, 62-63, 67, 465, 465/ 
conducting, 61-69 
critiquing work of others in, 67, 
68-69 

diplomatic communication in, 
67-68 

effective listening in, 62 
electronic tools for, 69-76 
memorable language, 596 
memorized presentations, 577 
memos, 360, 372-74 

cause-and-effect organizational 
pattern for, 163 
comparison-and-contrast 
organizational pattern for, 

156 

cultural considerations in, 
380-81 

elements of, 372, 372/ 
guidelines for, 374 
informational reports in form 
of, 454 

letters of transmittal in form of, 
479, 488, 488/ 

MLA works cited style for, 655 
progress reports in form of, 
454-61 

proposals in form of, 435-42 
sample trip reports in form of, 
372-73, 373/ 


writer’s checklist for, 382 
writing, 372-74 

men, collaboration patterns of, 77 
messaging technologies, 71-72 
methods 

in field reports, 450, 450/ 
in problem-methods-solution 
organizational pattern, 161 
metric system, 96 
microblogs, 72, 77-80, 193, 360 
cultural considerations and, 
380-81 

guidelines for, 379-80, 379/ 
netiquette and, 375, 377 
writer’s checklist for, 382 
writing, 377-80 
milestones, 63, 64/ 
military experience, listing on 
resumes, 404 
MILSPEC, 558 

minutes. See meeting minutes 
misplaced modifiers, 229 
MLA style, 615, 642, 645 
for ellipses, 610, 669 
for textual citations, 641-44 
for works cited entries, 641^2, 
644^7 

mobile applications, 251, 282/ 

290/ 

mobility impairment, and website 
design, 286 
modal verbs, 685 
moderation, 184 

Modern Language Association. See 
MLA style 
modesty, 184 

modified block format of letters, 
366, 366/ 
modifiers, 228-30 
dangling, 230 

imperative mood with, 230 
indicative mood with, 230 
misplaced, 229-30 
nonrestrictive, 228-29 
relative pronouns in, 228 
restrictive, 228-29 
squinting, 229 

modular documents, 107, 107/ 
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money constraints, in design, 255 
more-important-to-less-important 
organizational pattern, 150t, 
154, 156, 157 f 
guidelines for, 156 
signposts for, 156 
uses for, 154, 155 
writer’s checklist for, 167 
motion, showing of in graphics, 

327, 329/ 

motion pictures. See films 
multicultural audiences, 88, 

95-104. See also cultural 
considerations 
color and, 304, 334 
communicating with, 37-38, 
95-104, 242-43, 381 
definitions and, 535 
easy-to-translate text and, 
242-43 

editing and, 343 

graphics for, 104, 295, 304, 334-35 
headings and, 204 
interpreters and translators for, 
600 

lists and, 204 

modular documents for, 107, 

107/ 

revising and, 54 
writing for, 7, 99-104 
multilingual writers, guidelines for, 
677-91 

on adjectives, 689 
on adverbs, 690 
on articles, 688-89 
on conditions, 687-88 
on cultural considerations, 
677-79 

on helping verbs and main 
verbs, 685-86 
on infinitives, 684-85 
on -ing form of verbs, 684 
on linking ideas by coordination, 
681 

on linking ideas by 
subordination, 681-82 
on omitted words, 690-91 
on repeated words, 691 


on sentence characteristics, 
679-81 

on subject-verb agreement, 
686-87 

on verb tenses, 682-84 
multiple audiences, 107 
multiple authors 

APA reference list style for, 621 
APA textual citations style for, 
618, 619 

IEEE reference list style for, 635 
MLA works cited style for, 647 
multiple-choice questions, 140t 
multiple sources, APA citation style 
for, 619 

multivolume works 

APA reference list style for, 623 
MLA textual citations style for, 
644 

MLA works cited style for, 648 

navigation, website, 283, 283/, 284/ 
necessary criteria, 472-73 
negation, in extended definitions, 
540—41 

negative constructions, 234-35 
negative space, 263. See also white 
space 

nervousness, oral presentations 
and, 597-99 

netiquette, 375-76, 376/-77/, 377 
network diagrams, 435, 435/ 
networking sites, 394 
newsletter articles, APA reference 
list style for, 625 
newspaper articles 

APA reference list style for, 625, 
629 

IEEE reference list style for, 

637 

MLA works cited style for, 650, 
652 

newspapers, 122-23 

print vs. online versions of, 123, 
129-30 

Neu; York Times, 122 
nominalizations, 226-27, 237 
non-coated paper, 256 


Nondesigner’s Design Book, The 
(Williams), 251 
non-English books 

APA reference list style for, 623 
MLA works cited style for, 648 
nonfluencies, in oral presentations, 
599 

nonnative speakers of English. 

See multicultural audiences; 
multilingual writers 
nonprofessional positions, 401 
non-proportional typefaces, 406 
nonrestrictive modifiers, 228-29, 
660 

nonsexist language, 240^1 
nontraditional student, skills 
resume for, 408 

nonverbal communication, 67-68 
notebooks, and lab reports, 517 
note taking, 607-13 
nouns 

compound, 671 
countable common, 688-89 
demonstrative pronouns and, 
211 

plural, 666-67, 688 
proper, 660-61, 675, 688 
in sentence definitions, 537 
in sentences, 680 
trademarks as, 27 
uncountable common, 689 
noun strings, 197, 235 
numbered lists, 200-01, 203 
numbers 

commas and periods in, 96, 661 
guidelines for, 671-73 
hyphens with, 671 
parentheses with, 665 
numerical information 
as evidence, 176-77 
graphics for, 296, 306, 307/, 
310-12, 310/ 

object descriptions, 543 
detail in, 546-47 
introducing, 545, 545t 
objectivity, and passive voice, 

231 
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observations 

in primary research, 133-34 
in usability evaluation, 347 
obvious statements, 236-37 
Occupational Outlook Handbook, 392 
Occupational Safety and Health 
Administration (OSHA), 558 
ombudspersons, 31, 174 
omitted words or phrases, 660, 
690-91 

100-percent bar graphs, 316t 
online books, MLA works cited style 
for, 652 

online catalogs, 121 
online databases, 120 

IEEE reference list style for, 639 
online dictionaries, APA reference 
list style for, 627 
online document design. See 
design; website design 
online encyclopedias, APA 

reference list style for, 627 
online magazine articles, APA 
reference list style for, 629 
online periodical articles, MLA 
works cited style for, 652 
online postings 

APA reference list style for, 

629-30 

MLA works cited style for, 

654 

opposing viewpoints, in arguments, 
177, 179 

oral presentations, 577-604 
advance organizers in, 581, 

595 

answering questions after, 582, 
600-01 

audience for, 578, 579, 586, 596, 
600 

body language in, 599-600 
conclusion to, 581-82, 595 
delivering, 597-600 
effective language for, 593-96 
equipment for, 586 
evaluation form for, 601, 602/-03/ 
handouts for, 593 


honesty in, 601 
introduction to, 581 
length of, 586 

organization of, 580-82, 588 
preparing for, 578-82 
presentation software for, 
585-86, 593 

purpose of, 579-80, 581 
rehearsing, 578, 597 
role of, 577-78 

slides for, 578/, 582-88, 583 /, 584/ 
585, 587/ 588/ 589/-92/ 
speaker’s checklist for, 604 
speaking notes for, 593 
summaries in, 595 
transitions in, 594, 596 
types of, 577 

U.S. communication style and, 
677-79 

organization. See also 

organizational patterns 
editing and, 343 
graphics and, 588 
headings and, 194 
of instructions, 561 
of manuals, 569-71 
of oral presentations, 580-82, 

588 

of progress and status reports, 
452, 452/ 453 
of proposals, 429, 436^2 
of recommendation reports, 475, 
477, 480 
of resumes, 398 
organizational culture 
fluidity of, 99 
variables in, 97-98 
organizational patterns, 146-66 
audience analysis and, 147-48 
cause-and-effect, 150t, 163-65, 
165/ 167 

chronological, 149t, 151-52, 152/ 
167 

classification, 150t, 158-60, 161/ 
167 

comparison and contrast, 150t, 
156-58, 159/ 167 


general-to-specific, 150t, 151/ 
154, 155/ 167 
more-important-to-less- 

important, 150t, 154, 156, 157/ 
167 

multiple, 151/ 

paragraph structure and, 206-07 
partition, 150t, 151, 158-60, 160/ 
162/ 167 

principles of, 147-49 
problem-methods-solution, 150t, 
151/ 160-63, 164/ 167 
spatial, 149t, 153, 153/ 167 
topic sentences and, 205, 205/ 
writer’s checklist for, 167 
organization charts, 160, 165, 308t, 
323-24, 324/ 
organizations 

APA citation style for, 618-19 
APA reference list style for, 621 
IEEE reference list style for, 635 
MLA textual citations style for, 
643 

MLA works cited style for, 647 
outline view 

editing and, 344 
using, 46 

oversimplifying, 183t 
overstatement 

in cause-and-effect 

organizational pattern, 165 
in progress and status reports, 
453 

overview, in manuals, 570 
page count, 256 

page design, 260-79. See also design; 
website design 

creating borders and screens for, 
275 

creating text boxes for, 275 
chunking and, 260, 260/ 
color and, 275 
double-column, 263/ 276f 
filtering and, 261, 261/ 
goals of, 250 

guidelines for, 260-61, 557 
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for instructions, 555-57, 557t 
layout in, 262-64 
for magazine page, 270/ 
one-column, 277/ 
poor, 279/ 

queuing and, 261, 261/ 
three-column, 263/ 278/ 
white space and, 263-64 
writer’s checklist for, 291 
page grids, 262, 262/, 263/ 
page layout, 262-64 

page grids for, 262, 262/ 263/ 
white space in, 263-64 
page numbering, 259t 
page numbers 

APA reference list style for, 
620-21, 624, 628 
in documents, 482 
IEEE reference list style for, 635, 
636, 638, 639 

MLA textual citations style for, 642 
ML A works cited style for, 645, 
649, 653 

in tables of contents, 481 
page size, 256 
pamphlets 

APA reference list style for, 630 
MLA works cited style for, 655 
paper, 256 
size of, 255 
paragraphs, 204-12 
body, 204 

cultural considerations in, 148 
demonstrative pronouns in, 
211-12 

dividing, 208-09 
editing of, 344 
in email, 377, 377/ 
length of, 208-09, 286 
lists vs., 198-200, 199/ 209 
repeating key words in, 211 
structuring, 205-09 
topic sentences in, 205-06, 205/ 
transitional, 204, 207 
using transitional words and 
phrases in, 209-11, 209t 
writer’s checklist for, 213 


parallel structure 

for items in a series, 227 
for lists, 201 
for sentences, 227-28 
paraphrasing, 607-09 

APA textual citation style for, 618 
documentation of, 614 
example of, 608/ 
guidelines for, 609 
in note taking, 607-09 
of titles, 206, 609 
parentheses, 665-66 
parenthetical definitions, 536 
parenthetical elements, 665 
part-by-part pattern, 157, 158 
part-by-part section, in 
descriptions, 546 
participial phrase, 684 
particular descriptions, 544 
partition organizational pattern, 
150t, 151, 158-60, 160/ 162/ 
in extended definitions, 538-39 
guidelines for, 160 
uses of, 158-60 
writer’s checklist for, 167 
passive voice, 686 

appropriate use of, 231-33 
in instructions, 562 
in lab reports, 520 
locating of with grammar- 
checkers, 233 
in resumes, 400, 401/ 
past speculation, and verb tense, 
688 

past tense 

in lab reports, 529 
perfect, 222-23, 683, 685 
perfect progressive, 684 
progressive, 683 
simple, 682 

patterns, color, 304. See also 
organizational patterns 
for pie charts, 323 
peer reviews, 527 
Peitrequin, Herve, 319, 320/ 
people, graphic portrayal of, 335 
people-first approach, 241^2 


perfect binding, 257t 
periodical articles 

APA reference list style for, 620, 
623-25, 628 

IEEE reference list style for, 634, 
637, 638, 639 

MLA works cited style for, 645, 
649, 650, 652 

online, MLA works cited style 
for, 652 

periodical indexes, 122 
periods 

in abbreviations, 664, 674 
comma splices and, 218 
in numbers, 96, 661 
run-on sentences and, 219 
uses of, 664 
persona, 184 
creating, 184 
writer’s checklist for, 189 
personal communication 
APA reference list style for, 

631 

APA textual citation style for, 
619, 631 

personal information, on resumes, 
404-05 

personnel constraints, in 

persuasive writing, 174 
persuasive writing, 171-88 
argument in, 175-82 
audience analysis and, 171-73 
cultural variables and, 182, 
425-26 

examples of, 186-88 
graphics in, 185, 187/ 
in job-application letters, 186/ 
in lab reports, 516-17 
logical fallacies and, 182, 
182t-83t 

photographs in, 184, 185/ 
real and expressed purpose in, 
108 

testimonials in, 186, 186/ 
uses of, 171 

writer’s checklist for, 189 
phantom drawings, 333/ 
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photographs, 330 
cropping, 330, 331/ 
labeling, 330 

MLA works cited style for, 656 
perspective of, 330 
persuasive communication with, 
184, 185, 185/ 
scale of, 330 
uses of, 309t, 330 
phrases, punctuation of in lists, 
202-03. See also language 
picas, 262, 262/ 

“Pictures Please — Presenting 
Information Visually” 

(Horton), 306 

pie charts, 308t, 314, 322-23, 322/ 
pilot usability tests, 350 
pitch, in oral presentations, 599 
pity, appeal to, 183t 
placement bureaus, 396 
plagiarism, 26 
self-, 33 

plain-text resume, 405-08, 407/, 

408/ 

planning, 42-48 

for correspondence, 359 
for design, 254-55 
for job search, 387, 391-93 
project management and, 60-61 
for proposals, 421, 425 
purpose and, 43, 255 
for recommendation reports, 470 
for resources, 255 
writer’s checklist for, 55 
plan of work, in proposals, 430 
plural abbreviations, 674 
plural nouns, 666-67, 688 
plural pronouns, 241 
podcasts 

APA reference list style for, 629, 
631 

MLA works cited style for, 654 
research using, 126 
points (type size), 268 
political constraints, in persuasive 
writing, 174 

political variables, and culture, 96 


portfolios, in job searches, 392 
positive constructions, 234-35 
possession, 666 
post hoc reasoning, 183t 
PowerPoint, 582, 583/ 585, 587/ 

588/ 589/-92/. See also 
presentation slides 
precise words, 233 
in titles, 193-94 
prefaces 

for manuals, 570 
skimming, 606 
prefixes, 671 

preliminary research, for proposals, 
430 

preliminary results, in progress and 
status reports, 453 
prepositional phrases, 237-38 
preprint articles, APA reference list 
style for, 627 

presentations, oral. See oral 
presentations 
presentation slides, 583-88, 
589/-92/ 595/ 

APA reference list style for, 629 
presentation software, 585-86, 593 
present-future speculation, 687 
present participles, 684 
present tense, 222-23 
perfect, 683, 685 
perfect progressive, 684 
progressive, 683 
simple, 682 

press releases, 110-11, 110/ 
articles based on, 111 / 
example of, 110/ 

Prezi, 582, 583/ 585 
primary audience, 85, 86/ 88 
primary research, 115, 130^3 
categories of, 130 
demonstrations as, 133-34 
experiments as, 134-35 
field research as, 135-36 
inquiries as, 138 
inspections as, 134 
interviews as, 136-38 
observations as, 133-34 


proposals and, 429-30 
questionnaires as, 138-43 
selecting methods of, 116-20 
principal investigators, 430 
principles of operation, 539 
printable version of website, 285 
print document design. See design; 

page design 
print media, 120 

private life, vs. business life, 97-98 
problem-methods-solution 

organizational pattern, 150t, 
151/ 160-63, 164/ 
components of, 160-61 
guidelines for, 162-63 
logical sequence for, 163 
uses of, 160-63 

problem-solving model, 470-74, 
471/ 

procedures, in lab reports, 520, 528 
process descriptions, 543 
detail in, 546-47 
example of, 549, 549/ 553, 553/ 
graphics for, 296-308, 326-29, 
549/ 

instructions vs., 560 
introducing, 545, 545t 
showing motion in, 327, 329/ 
writer’s checklist for, 571-72 
product descriptions, 159 
professional appearance, as 
measure of excellence, 8 
professional brand, 386-91 
establishing, 386-88 
presenting, 389-90 
professionalism, 427 
professional persona, 184 
professional placement bureaus, 
396 

professional titles, commas with, 
661 

profiles, on social-media sites, 
394/-95/ 396 

progress reports, 446, 451-61 
conclusions of, 453, 460/ 

Gantt charts in, 459 
honesty in, 452 
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organization of, 452, 453 
for research projects, 424 
sample, 453-61 
secondary research for, 456 
summaries for, 454 
tone in, 453 

writer’s checklist for, 466 
writing, 451-61 
project budgets, 117 
project descriptions, in proposals, 
426, 429 

project management, 60-61 
project reports, 424, 469. See also 
recommendation reports 
project schedules 

honesty about in progress 
reports, 452 

for producing print documents, 
255 
pronouns 

antecedents for, 219-20, 222, 243 
relative, 687 

verb agreement with, 686 
proofreading, 42, 54-55, 345 
abbreviations for, 658 
of correspondence, 359 
of email, 376, 376/ 
of informational reports, 447 
of instructions, 563 
reading aloud for, 345 
of recommendation reports, 470 
symbols for, 676 
writer’s checklists for, 55, 355 
proper nouns 
articles and, 688 
capitalization for, 675 
for direct address, 660-61 
proposals, 420-43 

budget information in, 427, 432, 
441 

comparison-and-contrast 

organizational pattern for, 156 
credentials in, 427, 437, 442 
deliverables in, 422-24 
demonstrating professionalism 
in, 425-27 

evaluation techniques in, 435 


external, 420-22, 425 
for goods and services, 424 
honesty in, 427 
internal, 420-21, 425, 435-42 
international, 425-26 
introduction to, 429, 437-38 
logistics of, 420-22, 423 / 
in memo format, 435-42 
more-important-to-less- 
important organizational 
pattern for, 154 

partition organizational pattern 
for, 161 

plan description in, 427 
plan of work in, 430 
problem-methods-solution 
organizational pattern for, 161 
proposed tasks in, 438-39 
qualifications and experience 
section in, 430, 432 
quality control measures in, 427 
readers’ needs and, 425-26 
references in, 442 
research, 424 
sample internal, 435-42 
solicited, 422, 423/ 
statement of purpose in, 429, 436 
structure of, 428-29 
summaries in, 429, 436-37 
tables in, 433, 434 
task schedules in, 427, 433, 433/, 
441 

types of, 420-22 
unsolicited, 422 
writer’s checklist for, 443 
writing process for, 420, 421, 428 
proposed programs, 430, 431 
prototypes, 345, 346/ 349 
proximity, in design, 251, 252/ 
public, ethical obligations to, 22-23 
publication date 

APA reference list style for, 621, 
622, 624, 626 

IEEE reference list style for, 636, 
638, 639 

MLA works cited style for, 645, 
646, 649, 651, 653 


publication information 

APA reference list style for, 620 
IEEE reference list style for, 634, 
636 

MLA works cited style for, 645, 
646 

Publication Manual of the American 
Psychological Association (APA), 
614. See also APA style 
publisher information 

APA reference list style for, 622 
evaluating, 129 

IEEE reference list style for, 636 
MLA works cited style for, 646 
pull quotes, 272, 274t 
punctuation, 659-69 
of lists, 202-03 
purpose 

of correspondence, 359 
of definitions, 535-36 
design and, 255 
determining, 43, 84-85, 89, 
108-09, 117 

of email, 376, 376/, 377, 377/ 
formality level and, 230-31 
of graphics, 300 
of informational reports, 446 
of instructions and manuals, 569 
for lab, 527-28 
of memos, 374 
of microblogging, 379 
of oral presentations, 579-80, 581 
organization and, 148 
of progress reports, 454 
of proposals, 420 
in reading documents, 89 
of recommendation reports, 477, 
488, 490-91 
revising for, 52, 110-11 
titles and, 193 

QR code, 390 

qualifications and experience 
section, for proposals, 430, 

432 

qualifications summary, in 

chronological resumes, 398 
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qualifying information, placement 
of in sentences, 224 
qualitative evaluations, 435 
quantifiers, verb agreement with, 
686 

quantitative data, APA reference 
list style for, 627 
quantitative evaluations, 435 
question-and-answer sessions, 582, 
600-01 

question marks, 664, 668 
questionnaires, 119t, 138^3 
administering, 141 
presenting data from, 141, 143 
sample of, 142/ 
testing, 141, 497 
types of questions on, 140t-41t 
questions 

communicating diplomatically 
through, 68 

in job interviews, 411, 413 
Likert-scale, 140t, 142/ 
multiple-choice, 140t 
with oral presentations, 582, 
600-01 

on questionnaires, 140t-41t 
ranking, 140t 

in research interviews, 136-37 
short- answer, 141t, 142/ 
short-essay, 141t 
in usability testing, 351-52 
queuing, and page design, 261, 261/ 
quick response code, 390 
quotation marks 

other punctuation with, 664, 668 
uses of, 667-68 
quotations 

APA citation style for, 618 
documentation of, 614 
ellipses in, 610 
formatting, 667-68 
MLA works cited style for, 643 
in note taking, 607, 609-10 
in oral presentations, 596 

radio programs, MLA works cited 
style for, 656 

ragged-right justification, 269 


ranking questions, 140t 
ranks, distance between, 98 
raw data, APA reference list style 
for, 629 
readability 
case and, 267 
design and, 7, 287 
justification and, 271 
typeface and, 266, 266/ 
readers. See audience(s) 
reading aloud, in proofreading, 

345 

read-throughs, 426 
“real” subjects, in sentences, 225-26 
“real” verbs, in sentences, 226-27 
reasoning, in arguments, 175-76 
recognition, and persuasive writing, 
172, 173/ 

recommendation reports, 446, 

469- 511 

abstract in, 479, 480, 480t, 491 
appendixes in, 487, 511 
back matter in, 476t, 484-87 
body of, 476-78 
conclusions in, 478, 488, 507 
cover of, 479 

executive summary in, 476t, 
483-84, 493 

feasibility studies in, 469-70 
front matter in, 471, 476t, 479-84 
glossary in, 476t, 484, 486, 487/ 
introduction in, 476-77, 494 
keyword lists in, 479, 491 
as last link in document chain, 
469 

letter of transmittal with, 479, 
488-89 

list of illustrations in, 481, 483, 
483/ 

list of symbols in, 484, 486, 487/ 
methods section in, 477-78, 493, 
496 

multicultural audiences and, 
475-76 

presenting honest 

recommendations in, 475 
problem-solving model for, 

470- 74 


purpose of, 477, 488, 490-91 
recommendations in, 478, 489, 
491, 493, 495, 509 
references in, 486-87, 510 
results section in, 477-78, 500-06 
sample, 487-511 
table of contents in, 480-81, 492 
title page of, 479 
writer’s checklist for, 512-13 
writing, 470, 475-86 
recommendations 

in memos, 373, 373 /, 374 
in recommendation reports, 478, 
489, 491, 493, 495, 509 
recycled paper, 256 
Redish, Janice, 351 
redundant expressions, 237 
references (bibliographic) 

APA style for, 616-32 
IEEE style for, 634-40 
in lab reports, 523, 528, 530 
in proposals, 430, 439, 442 
in recommendation reports, 
486-87, 510 
skimming, 606 
references (professional and 

academic), on resumes, 403 
reference works, 121 

APA reference list style for, 623, 
627 

guides to, 121-22 
MLA textual citation style for, 
644 

MLA works cited style for, 648 
registered trademarks, 26, 27 
rehearsing, of oral presentations, 
578, 597 

relative pronouns, 219-20 
verb agreement with, 687 
religious variables, 96 
relocation willingness, listing on 
resumes, 404 
repetition 

of color, 258, 304 
columns and, 265 
design and, 251-52, 253/ 
of key words, 211 
marginal glosses and, 274t 
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of safety information, 559 
of words in sentences, 691 
replicability, 520 

reports, 446. See also informational 
reports; recommendation 
reports 

APA reference list style for, 629, 
630 

cause-and-effect organizational 
pattern for, 163 
chronological organizational 
pattern for, 151 
format of, 482 

general-to-specific organizational 
pattern for, 154 

IEEE reference list style for, 637 
MLA works cited style for, 655 
modular, 107, 107/ 
request for proposal, 422, 428, 435 
request for quotation, 423, 423 /, 

428 

research, 115-43. See also research 
proposals 

academic vs. workplace, 115-16 
choosing methods for, 116-20, 
118t-19t 
field, 135 

in informational reports, 455-59 
in lab reports, 520-21, 522 
in planning process, 45 
primary, 115, 117, 130-43 
in proposals, 429-30 
in recommendation reports, 477 
secondary, 115, 117, 120-30, 430, 
439, 456 

triangulating, 119 
writer’s checklist for, 144 
research proposals, 422, 424 
preliminary research for, 430 
writing, 428 

research reports, APA reference list 
style for, 629, 630 
resource links, on websites, 285 
response to an inquiry, 366, 368 
restrictive modifiers, 228-29 
results 

in field reports, 450, 451 
in lab reports, 520-21, 529 


in progress reports, 453 
in recommendation reports, 

476t, 477-78, 488, 492-93 
resume-preparation agencies, 397 
resumes, 392-94, 397-410 

active vs. passive voice in, 400, 
401/ 

chronological, 387, 398-405 
content of, 390-94, 397-404 
education on, 399-400, 407/, 408/, 
409/ 410 

electronic, 406-08, 407 /, 408/ 
employment history on, 400-02 
formatted, 409 

identifying information on, 398 
interests and activities on, 
402-03 

keywords on, 397 
for nontraditional student, 408/ 
plain-text, 405-08 
posting of on job boards, 397 
references on, 403, 407 
skills, 387, 398, 401, 405, 408/ 
summary of qualifications on, 
398 

using preparation agency for, 

397 

writer’s checklist for, 416 
retrieval dates 

APA reference list style for, 626 
IEEE reference list style for, 639 
MLA works cited style for, 645, 
651, 653 

reviewing, 341^5 

acknowledging others’ 
contributions to, 54 
editing as, 343-45 
by people from other cultures, 

54, 101 

proofreading as, 345 
relationship of to evaluating and 
testing, 341-42, 342/ 
revising as, 342-43 
word-processing features for, 
70-71 

of work of others, 68-71, 78 
review process, for scientific and 
engineering articles, 527 


reviews, MLA works cited style for, 
650 

revising, 52-54, 342^3, 447 
of correspondence, 359 
electronic tools for, 69 
of headings, 197-98 
of informational reports, 447 
of instructions, 563 
for new audiences, 100-11 
of proposals, 421 
of recommendation reports, 470 
writer’s checklists for, 55, 355 
revision feature, in word 
processors, 70-71 

RFP, 422, 428, 435 

RFQ, 423, 423/ 428 
rights, standard of, 19 
ring binders, 257t 
RSS aggregator, 127 
RSS feeds, 126-27, 128/ 

RSS (rich site summary; really 
simple syndication) 
technology, 126-27, 347 
Rubin, Jeffrey, 352 
rules (design term for lines), 273t 
in page layout, 272, 272t 
run-on sentences, 218-19 

saddle binding, 257t 
safety information 

design of, 38, 38/ 558-60 
in instructions, 558-60, 559/ 
in manuals, 558-59 
placement of, 559, 560/ 
repetition of, 559 
signal words in, 558, 559, 559/ 
salutations 

cultural variables in, 98, 103 
in letters, 364, 364/ 
sans-serif typefaces, 255, 266, 266/ 
268 

schedules. See project schedules; 
task schedules; work 
schedules 
science 

articles in, 523, 526, 526/ 527 
lab notebooks in, 517 
scientific method, 520 
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scientific reports, IEEE reference list 
style for, 637 

scope, of recommendation reports, 
477, 480 
screens 

creating, 275 
density of, 274t 
page design and, 272, 275, 281, 
282/, 289 / 
screen shots 
creating, 332 
uses of, 309t, 330, 331/ 
scripted presentations, 577, 597 
search pages or engines, 92, 285 
secondary audience, 88-89 
secondary research, 115, 120-30 
evaluating information from, 
127-30 

for progress reports, 456 
for proposals, 430, 439 
social media and other 
interactive resources for, 
124-27 

traditional tools for, 121-24 
sections in edited books 

APA reference list style for, 623 
IEEE reference list style for, 635 
MLA textual citations style for, 
644 

MLA works cited style for, 648 
security, and persuasive writing, 
171-72 

security notices, 479 
self-confidence, and oral 
presentations, 598 
self-evaluation form, 66/ 
self-inventory, for job search, 391 
semantic differentials, 140t 
semicolons 

comma splices and, 218 
independent clauses and, 218, 
662, 681 

with items in series, 662-63 
misuses of, 663 
run-on sentences and, 219 
uses of, 662-63, 681 
sentence definitions, 536-37, 542, 
542/ 


sentence fragments, 216-17 
sentence list, 200 
sentences, 216^13 

characteristics of, 679-81 
combining, 225 
conditions in, 687-88 
editing, 344 
emphasis in, 223 
grammatical, 216-23 
helping and main verbs in, 

685- 86 

infinitives in, 684-85 
-mg verbs in, 684 
length of, 101, 224-25, 243, 

287 

linking ideas in, 681-82 
modifiers in, 228-30 
parallel structures in, 227-28 
pronoun-antecedent agreement 
in, 222 

pronoun references in, 219-20 
qualifying information in, 224 
“real” subjects in, 225-26 
“real” verbs in, 226-27 
repeated words in, 691 
run-on, 218-19 
structuring, 223-30 
subject-verb agreement in, 222, 

686- 87 

verb tenses in, 222-23, 682-84 
words omitted from, 690-91 
writer’s checklist for, 243 
sequence 

of graphics, 334 
of information in lists, 199 
series, items in 
commas for, 659 
parallel structure for, 227-28 
semicolons for, 662-63 
series books, MLA works cited style 
for, 648 

serif typefaces, 255, 266, 266/ 
sexist language, 39, 240-41 
shading, in screens, 274t, 275 
shapes, creating of with drawing 
tools, 309t 

shared document workspaces, 
74-75 


short-answer questions, 141t, 142/ 
short-essay questions, 141t 
signal words, 558, 559, 559/ 560/ 
signatures 

in emails, 375, 375/ 
in letters, 365, 365/ 
in memos, 372, 372/ 
simplicity 

in presentation graphics, 584 
revising for, 240 
in web page design, 287, 288, 
289/ 

Simplified English, 242, 535, 570 
site maps, 283, 283/ 

Skillcrush, 186/ 
skills resumes, 387 

education section on, 408/ 

409/ 

employment section on, 408, 
408/ 

skills section on, 395, 408, 408/ 
409/ 

skimming, 606-07 
slang, 101 

slides. See presentation slides 
SMEs (subject-matter experts), 53, 
346^7 

Smith, Terry C., 582 
social-bookmarking sites, 126 
social media 

for audience analysis, 92-94, 93/ 
94/ 

for collaboration, 69-71 
ethical and legal use of, 32-34 
for job search, 388 
policy on, 32-34 
professional presence on, 76, 
388-89 

for research, 118t, 121 
website references to, 285 
social variables, 96 
solicited proposals, 422 
solutions, in problem-methods- 
solution organizational 
pattern, 161 

sources. See documentation 
of sources; references 
(bibliographic) 
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spacing 

APA reference list style for, 620 
IEEE reference list style for, 635 
MLA works cited style for, 645 
spam, 541 

spatial information, on graphics, 
296, 310t, 330-34 

spatial organizational pattern, 149t, 
153, 153 / 

guidelines for, 153 
signposts for, 153 
topic sentences and, 204 
writer’s checklist for, 167 
speaker’s checklist, 604 
speaking. See also oral 
presentations 
U.S. style of, 678 
in videoconferencing, 73 
speaking notes, 593 
specifications, 552, 552 /, 570 
specificity, 233 

in lab report titles, 528 
in questions on questionnaires, 
140 

in recommendations, 475, 478 
in sentence definitions, 537 
speech. See also oral presentation 
APA reference list style for, 

631 

MLA works cited style for, 655 
speed of speaking, in presentations, 
599 

spell-checkers, 55 
spiral binders, 257t 
square brackets, 669 
squinting modifiers, 229 
standards 

IEEE reference list style for, 

637 

in manuals, 570 
states, commas with, 661 
status reports, 451-53 
conclusions of, 453 
organization of, 452, 452/ 
tone in, 453 

writer’s checklist for, 466 
writing, 451-53 

step-by-step instructions, 561-63 


step-by-step section, in 
descriptions, 546-47 
stratum bar graphs, 317/ 
structuring effective sentences, 
223-30 

stub, in tables, 310, 310/ 311 
style guides. See also APA style; IEEE 
style; MLA style 
on citation of graphics, 303 
company-specific, 479 
for specific disciplines, 615-16 
styles, 195 
creating, 196 
modifying, 196 
using, 51 
style sheets, 63 
subdivided bar graphs, 316t 
subheadings, 480 
subject (of communication) 
analyzing, 117 
formality level for, 230 
generating ideas about, 44 
revising and, 52, 225 
title and, 193-94 
subject (of sentence) 

agreement of with verb, 222, 
686-87 

commas and, 662 
compound, 662, 686 
omitting, 691 
“real,” 225-26 
repeating, 692 
subject lines 

in emails, 375, 375/ 376, 376/ 
377, 377/ 

in letters, 364, 364/ 
in memos, 373, 373/ 374 
in progress reports, 454 
in proposals, 436 
in recommendation reports, 

488 

subject-matter experts (SMEs), 53, 
346-47 

usability evaluation and, 346, 

347 

sublists, 201 

subordinating conjunctions, 220, 
682 


subordinating words or phrases, 
220, 682 

subordination, linking ideas with, 
220, 681-82 

subscription service articles, MLA 
works cited style for, 652 
suffixes, 671 
summaries 

APA citation style for, 618 
example of, 611/-13/ 
in incident reports, 463, 463/ 

464, 464/ 
kinds of, 610 
in memos, 374 
in note taking, 607, 610-11 
in oral presentations, 595 
in progress reports, 454 
in proposals, 429 
in recommendation reports, 476, 
473-74, 493 
writing, 610-11 
summary statement, in 

chronological resumes, 398 
summative evaluation, 435 
supporting information 
in paragraphs, 206-07 
in presentation graphics, 584/ 
supporting letters, with proposals, 
432-33 

surveys, in usability evaluation, 347 
symbolic meaning of colors, 255, 
304, 305, 305/ 
symbols. See also icons 

cultural considerations with, 

335 

licensing, 25/ 
lists of, 484, 486, 487/ 
for proofreading, 676 
trademark, 26, 27, 37 

table of contents 
creating, 480-81 
cultural considerations in, 
475-76 

in online documents, 284/ 
organizational pattern and, 149 
for recommendation reports, 
476, 480-81, 492 
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table of contents (cont.) 
skimming, 606 
typeface of headings in, 481 
for websites, 284, 284/ 
table-of-contents abstract, 480 
tables, 306 

arrangement of data in, 311, 327/ 

creating, 314 

cross-referencing, 259t 

dot leaders in, 311 

footnotes in, 312 

guidelines for, 310-12 

in lab reports, 521, 529 

lists of, 481-82 

math in, 311 

meeting minutes as, 464-65 
parts of, 310t 
in proposals, 433-34 
rules in, 312 
saving space with, 296 
sources in, 310/, 312 
task lists as, 327, 327/ 
titles of, 306 

units of measure in, 310-11 
uses of, 306-12, 308t 
width of, 312 

tabs, as accessing aids, 258t 
tab stops, 313 
tagged content, 126, 127/ 
tags, commas with, 688 
task pattern, in progress and status 
reports, 452, 452/, 453 
tasks, and project management, 61, 
62, 63 

task schedules, for proposals, 427, 
433, 433/, 441 
team members 

critiquing work of, 67-69 
evaluation form for, 65/ 
tasks for, 63 

videoconferencing with, 72-73 
Tebeaux, Elizabeth, 97 
technical communication, 2-15 
career development and, 11-12 
challenges of, 5-6 
characteristics of, 7 
cultural variables in, 95-101 
defined, 3-5 


measures of excellence in, 7-9 
sample, 13/, 14/, 15/ 
technical communicators 
defined, 3 

ethical obligations of, 21-23 
legal obligations of, 24-29 
technical information, photographs 
for, 185, 185/ 
technical reports 

APA reference list style for, 629, 

630 

IEEE reference list style for, 637 
technological variables, 96 
Tech Tip 

on appear and dim animation 
effect, 588 

on borders and screens, 275 
on drawing tools, 320 
on formatting columns, 265 
on formatting fonts, 267 
on Gantt charts, 434 
on graphics in Excel, 314 
on headers, footers, and page 
numbers, 482 

on inserting and modifying 
graphics, 302 
on master page design in 
PowerPoint, 587 
on modifying and creating 
styles, 196 

on modifying justification, 271 
on modifying line spacing, 271 
on modifying templates, 49 
on numbered and bulleted lists, 
203 

on outline view, 46 
on review tab, 70 
on screen shots, 332 
on setting up pages, 257 
on styles, 51 
on table of contents, 482 
on tables, 314 
on tab stops, 313 
on text boxes, 275 
television programs 

APA reference list style for, 

631 

MLA works cited style for, 656 


templates, 48-50 

for meeting minutes, 464, 464 /, 
465 

modifying, 49 

for presentation graphics, 585 
tenses. See verb tenses 
tertiary audience, 89 
testimonials, 186, 186/ 
testing, 341-42, 342 f. See also 
usability tests 
of questionnaires, 141 
test plans, in usability testing, 350 
Texas Instruments, 30-31 
text boxes, 275 
text direction, 255 
text messaging, 72 
text-only version of websites, 285 
text resumes, 405-08 
textual citations 

APA style for, 616, 618-19 
IEEE style for, 633-34 
MLA style for, 642-44 
textual links on websites, 283 
textual versions of links, 284 
theses 

APA reference list style for, 627 
IEEE reference list style for, 

637 

three-dimensional bar graphs, 297, 
297/ 

three-dimensional pie charts, 323 
three-panel brochure, 263/ 
thumbnail sketches, 262, 262/ 
time budget, for oral presentations, 
580, 580t 

time consciousness, in U.S. culture, 
677 

time constraints 
in design, 255 

in persuasive writing, 175, 255 
timeliness of information, 128-29, 
152/ 

time of day, expressing, 672 
TinyURL, 380 

title pages, of recommendation 
reports, 479, 490-91 
titles (academic and professional), 
661 
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titles (of documents) 
of bar graphs, 316 
of instructions, 561 
of lab reports, 518, 527, 529 
of oral presentations, 581, 589/ 
page design and, 272 
paraphrasing and, 194 
of recommendation reports, 479, 
490-91 

of tables, 306, 310/ 
working, 193 
writer’s checklist for, 213 
title slides, 581, 589/ 
tone 

in correspondence, 361-62 
in persuasive writing, 175 
in progress and status reports, 453 
in recommendations, 478 
tools and materials, list of, 565/ 
topical abstracts, 480 
topic sentences 

organizational pattern and, 149, 

205- 06, 205/ 

supporting information for, 

206- 07 

towns, commas with, 661 
trademark law, 26-27 
trademarks, 26 

ethical communication and, 34 
legal obligations and, 26-27 
manuals and, 598 
protecting, 27 
symbols for, 26, 27, 37 
trade secrets, 388 
transcripts of interviews, 138, 139/ 
transitional paragraphs, 204 
transitional words and phrases 
commas with, 660 
headings in place of, 195 
independent clauses and, 681 
paragraph coherence and, 
209-11, 209t 
placement of, 210-11 
transitions, in oral presentations, 
594, 596 

translated books 

APA reference list style for, 623 
MLA works cited style for, 648 


translation 

of graphics, 206, 535 
of manuals, 570 
of oral presentations, 600 
preparing text for, 242^3 
of proposals, 426 
transmittal letters, with 

recommendation reports, 
476t, 479, 488 
trip reports, 372, 373/ 

Trojan Horse, 536 
trouble reports, 462 
troubleshooting guides, 296, 567/ 
truth 

ethical communication and, 38 
euphemisms and, 236 
turnover lines, in lists, 201 
Twitter, 94/, 95, 132, 193, 285, 379 /, 
389 

two-dimensional bar graphs, 297, 
297/ 

typefaces, 265 
design and, 255 
for recommendation reports, 
481, 492 

serif vs. sans serif, 266, 266/, 
268 

type families, 266, 266/ 
type size, 306 
of headings, 272 
page design and, 268 
of titles, 272 
using responsibly, 268 
website design and, 286 
typography, 265-72 

case and, 267, 267/ 406 
justification and, 269-71 
line length and, 268 
line spacing and, 268-69, 269/ 
270/ 

in manuals, 570 
typefaces and, 265, 266, 266/ 
406 

type families and, 266-67, 266/ 
type size and, 267-68, 306 

uncertainty, 98-99 
uncountable common nouns, 689 


underlining 

descenders and, 272 
uses of, 669 

United States, communication style 
in, 677-79 

units of measure, in tables, 310-11 
“Universal Language, The: Graphics 
for International Documents” 
(Horton), 334 

university placement offices, 396 
unknown authors 

APA reference list style for, 623 
APA textual citation style for, 

619 

MLA textual citation style for, 

643 

MLA works cited style for, 647 
unpublished data 

APA reference list style for, 632 
IEEE reference list style for, 640 
unsigned articles, MLA works cited 
style for, 650 

unsolicited proposals, 422 
uppercase letters, 267, 267/ 406 
URLs 

angle brackets for, 670 
APA reference list style for, 625, 
626, 627 

breaking at end of line, 671 
MLA works cited style for, 645, 
651 

shortener for, 380 
usability evaluation, 345^18 
factors in, 341-42 
liability law and, 29 
multicultural audiences and, 348 
prototype in, 345, 346/ 349 
roles in, 346^7 
usability testing vs., 348-49 
writer’s checklist for, 355 
usability experts, 347 
usability labs, 350t 
usability service, 348 
usability tests, 348-53 
basic principles of, 349 
budgeting for, 48 
conducting, 351-52 
debriefing participants after, 352 
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usability tests (cont.) 

informed consent and, 352 
interpreting and reporting data 
from, 353 
pilot, 350 

preparing for, 349-50 
purpose of, 349 
test plan in, 350 
test team in, 350 
usability evaluation vs., 348^9 
users, document 

liability law and, 28-29 
as reviewers, 53 
in usability evaluation, 346^7 
in usability testing, 349 
U.S. government 

goods and services proposals 
to, 424 

RFPs and IFBs issued by, 422 
utility, standard of, 19 
UV-coated paper, 256 

Velasquez, Manuel, 19 
verb phrases, 685 
verbs. See also verb tenses 

action, for resumes, 400-01, 401/ 
agreement of with subject, 222, 
686-87 

clarifying purpose with, 108-09 
commas and, 661-62 
communicating, 108 
convincing, 108 
correcting sentence fragments 
with, 217 

helping and main, 685-86 
-ing , 684 
modal, 685 
nominalized, 226-27 
“real,” 226-27 
trademarks as, 27 
verb tenses, 222-23 
perfect, 683 

perfect progressive, 683-84 
progressive, 683 
simple, 682-83 

vertical axis, on graphs, 297-99, 315, 
321 

vertical bar charts, 312/ 


vertical rules, 273t 
videoconferencing, 72-73, 73/ 
videos 

instructional, 554-55 
MLA works cited style for, 

656-57 

website design and, 286 
virtual worlds, 75, 75/, 76 
viruses, 539 
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